JavaScript is disabled. Some features may not work. You can also read the static version: View text version

User Flows

Flow 1

Saved Card Flow

Flow 2

New Card Flow

User Journey

Sample Requests and Responses

With the existing implementation on Juspay , the transaction level details are available in the root structure of the orderStatus(/orders/:order_id) JSON block.

In some case, There will be a new status called as AUTO_REFUNDED, which indicates than primary card transaction is successful but the LOYLTYREWARDZ transaction got failed and JUSPAY has called REFUND for primary card transaction.
Only inCase of split transactions, orderStatus response will return txn_list as an array block in with the 2 transactions (CARD + LOYLTYREWARDZ). You need to make sure to consume the params from inside the txn_list array block.
As orderStatus response is changing incase of split transaction and AUTO_REFUNDED case, It will also effect webhook payload (If already handled no need for any change).

Order Status API

Request

Response

Reward Transaction

Card + Reward Transaction

Refund API

Refund cases

Refund requests (full/partial) can be initiated by a Juspay’s merchant at Transaction level or at Order level.
Given that LOYLTYREWARDZ transactions can be split between an existing Gateway and LOYLTYREWARDZ, the merchant can choose between one of the two provisions -
For Order based refunds,
a. merchant will have to pass order_id & amount (refund amount) to Juspay.
b. Order may have 2 transactions (Card and LOYLTYREWARDZ), Juspay will try to prioritise card transaction for refund and if the refund amount is greater than card transaction amount then JUSPAY will initiate refund call to LOYLTYREWARDZ
c. Merchant will receive Juspay’s refund response accordingly (post PG processing) and is expected to handle the same (new key “split_refund_details”)
For Transaction based refunds
a. merchant would initiate refunds against all transaction Ids, with transaction Id and amount to Juspay
b. Merchant will ensure the amount checks and the refund split for both full and partial refunds.
c. Juspay’s refund response will remain the same as what merchants currently see for transaction based refunds. No additional handling required.

Transaction Base Refund

Request

Response

Order Base Refund

Request

Response