Promotional Discounts

How to apply a promotional discount to a transaction

Overview:

MoneyGram frequently runs offers & promotions to incentivize and reward our customers. The Quote, Create, and Update APIs allow the customer to apply a discount to a transaction.

How to implement:

There are two way a customers can add a discount to their transaction:

Applying a promotionalCode :
- Promo codes are generated for a particular promotional initiative and can be nation wide, for a product or for particular partners. They are typically valid specific period of time.
- The Promotional Codes values are alpha-numeric strings.
- The application can pass a Promo-code in the promotionCodes field on the Quote, Create, or Update API request. promotionCodes field type is an array, by default only one promotion code can be applied to a transaction. If required by a partner, a configuration in the backend to allow multiple promotional codes to be entered for a single transaction.
Applying a rewardsNumber:
- A customer has to first enroll in the MoneyGram Plus Rewards loyalty program. Once the customer is enrolled, a unique MoneyGram Plus Rewards number is generated.
- The MoneyGram Plus Rewards number is a 12 character numeric string.
- The application can pass the MoneyGram Plus Rewards Number in the rewardsNumber field on a Quote, Create, or Update API endpoints.
- Customer will redeem loyalty discounts on the quote or accrue loyalty points for a future discount.

Example API Request & Response:

    "destinationCountryCode": "USA",
    "destinationCountrySubdivisionCode": "USA-MN",
    "serviceOptionCode": "WILL_CALL",
    "sendAmount": {
        "value": 100,
        "currencyCode": "USD"
    },
    "receiveCurrencyCode": "USD",

"discountsApplied": {
                    "totalDiscount": {
                        "value": 4.00,
                        "currencyCode": "USD"
                    },

UI Best Practice

We have provided the following wire frames as a basic guide to how Quote API response is typically handled by application UI:

Quote Summary

Updated about 1 month ago