Refund Message Sequences
These sequences describe the process for creating a full or partial refund.
Note
Some payment methods do not allow refunds. See the
is_refundablefield in the response to 'List Payment Methods by Country'.A refund can be created only when the status of the payment is CLO (closed).
Refunds must be issued to the same payment method that was used in the payment.
Multiple refunds can be issued against a single payment.
There is no limit on the number of refunds as long as the total does not exceed the amount of the payment.
Create Card Refund - Production Environment
In the production environment, the refund is completed when the card issuer accepts the funds from Rapyd.
The client sends a Create Refund request to Rapyd.
Rapyd sends a response with details of the refund transaction. The status of the refund is set to Pending.
Rapyd initiates the refund.
The card issuer accepts the refund and notifies Rapyd that the transaction is complete.
Rapyd sends Webhook - Refund Completed and debits the relevant client wallet. The status of the refund is set to Completed.
Create Card Refund - Sandbox Environment
In the sandbox, you can simulate the action of the card issuer by using Complete Refund.
The client sends a Create Refund request to Rapyd.
Rapyd sends a response with details of the refund transaction. The status of the refund is set to Pending.
The client sends Complete Refund request to Rapyd.
Rapyd sends a response to the request. The status of the refund is set to Completed.
Rapyd sends Webhook - Refund Completed and debits the relevant client wallet.
Create Card Refund - Transaction Rejected
A card issuer might reject a refund to a card that has expired or has been blocked or canceled.
The client sends a Create Refund request to Rapyd.
Rapyd sends a response with details of the refund transaction. The status of the refund is set to Pending.
Rapyd initiates the refund.
The card issuer rejects the refund and notifies Rapyd that the transaction is rejected.
Rapyd sends Webhook - Refund Rejected. The status of the refund is set to Rejected.