Applying store credit
Learn how to apply store credit.
Providing and highlighting a loyalty reward builds customer loyalty and increases profitability. This topic explains how to leverage the power of the store credit program to reward and retain loyal shoppers by leveraging the Commerce API.
To support store credit, Commerce API requires more than one source in a cart. You need to create a source for the payment the shopper is currently using and create another source for the store credit. Once you created both sources, you can attach them to the cart for the charge.
- 1.
- 2.
- 3.
- 4.Attach the primary source to the cart (for example, the credit card source). Note: If the secondary source can cover the entire order amount, you can skip this step.
- 5.
- 6.If you configured notifications, the shopper receives an order confirmation notification. See Post-order notifications for more information.
- 1.You can use Global Commerce to cancel an order or line item if it has not been shipped or fulfilled.
- 2.If you configured notifications, the shopper receives a cancellation notification. See Line item cancel completed for more information.
- 1.You cannot cancel an order or line item if it has been shipped or fulfilled. You need to return or refund the order or line item using Global Commerce, the Refunds API, or Returns API.
- 2.The shopper requests a refund. If you configured notifications, the shopper receives a user refund confirmation.
- 3.
Post-order notification (PON) polls events and collects data using real-time calls for your company or site. When an event occurs, it triggers a notification and sends the notification to your endpoint. The notifications are one way. Once you receive a notification, you are free to do whatever you want with that notification.
A PON tells you when a shopper uses store credit and how much store credit the shopper used when an event occurs. A PON is triggered when an order is submitted, refunded, or cancelled. The PON generates an XML containing the order data. The store credit amount and payment method amount will appear in the notification's
Order
object under extendedAttributes
. You can extract the content of an order event to see the amount the shopper paid by store credit and other payment methods.The following table shows that a PON is sent when: (1) a shopper submits an order, (2) a shopper requests a refund for an order or line item, and (3) a shopper cancels an order or line item.
Flow sequence | Event description | Post-order notification |
---|---|---|
1 | Shopper submits the order. | Notify the the client system to subtract the store credit. |
2 | Shopper requests a refund for the order or a line item. Digital River processes the refund for the customer. | Notify the client system to return the store credit. |
3 | Shopper cancels the order or a line item. | Notify the client system to return the store credit. |
The order submitted notification displays the payment method and store credit under
extendedAttributes
. If you want to receive a notification when an order event occurs, contact your Digital River representative. 
The line item cancel completed notification shows the cancelled store credit under
extendedAttributes
. If you want to receive a notification when the store credit was not consumed so you can reflect it on your system, contact your Digital River representative. 
The return notification shows the refunded store credit under
extendedAttributes
. If you want a post-order notification sent to your system to notify you that the store credit was not consumed so you can reflect it on your system, contact your Digital River representative.
Last modified 9mo ago