Wallet Operations
Learn about the different Razorpay Wallet operations, such as loading a wallet, accepting payments from a wallet, initiating refunds and sending cashbacks to a wallet
Watch Out!
We have discontinued support for this product, effective April 2023. As a result, we will not be onboarding new users for this product anymore.
This section details the following wallet operations with an amount of ₹ 500 as an example:
- : Customer wants to add ₹ 500 to the wallet.
- : Customer wants to pay ₹ 500 from the wallet.
- : Merchant wants to refund ₹ 500 to a wallet.
- : Merchant wants to send ₹ 500 as a cashback to a wallet.
- .
- from Razorpay Dashoboard.
- .
When a customer adds funds or money into the wallet, it is called loading a wallet. A wallet is created only when a customer adds funds or money into the wallet for the first time.
Follow the below steps for loading a wallet:
- Customer proceeds to from the normal payment flow for an amount, say ₹ 500, using the selected payment mode (Net Banking/Debit card/Credit card/UPI).
- You authenticate the customer in your backend and make a request for the payment made and the amount gets credited to your account.
- You make a request of ₹ 500 to the customer’s wallet.
- Customer’s wallet gets credited with ₹ 500 and your account gets debited with the same amount.
- Razorpay sends a ‘success information’ response which you may show to your customer.
The following image illustrates the flow of funds while loading a wallet:
Reloading the wallet at the time of checkout will have the same flow. This usually happens when the customer finds out that there is insufficient balance in the wallet at the time of making a payment.
Refer to the
to see the APIs with the examples that are used in this operation.Follow the below steps for accepting payment from a wallet:
- The customer initiates payment of ₹ 500 for an order from the wallet.
- You authenticate the customer in your backend and make a request with the
customer_id. - You make a request for the payment of ₹ 500.
- ₹ 500 gets debited from the customer’s wallet and your account gets credited with the same amount.
The following image illustrates the flow of funds when a payment is made from a wallet:
Refer to the
to see the APIs with the examples that are used in this operation.Follow the below steps to refund to a wallet when payment is made from a wallet:
- You make a request for a payment of ₹ 500 with the
payment_id. - Customer’s wallet gets credited with ₹ 500 and your account gets debited with the same amount.
Handy Tips
Refunds are always made against a payment. While making a refund, the customer (payee) is identified using the payment_id that is generated at the time of payment.
The following image illustrates the flow of refund made to a wallet:
Refer to the
to see the APIs with the examples that are used in this operation.Follow the below steps to send cashback to a wallet:
- You make a request of ₹ 500 with the
customer_id. - Customer’s wallet gets credited with ₹ 500 and your account gets debited with the same amount.
The following image illustrates the flow of cashback to a wallet:
Handy Tips
As per RBI Domestic Money Transfer (DMT) guidelines, you can transfer a maximum of ₹ 25000 to other wallets in a calendar month.
Refer to the
to see the APIs with the examples that are used in this operation.Payouts allow customers to transfer funds directly from their wallets to any of the linked bank accounts.
If there are no bank accounts linked to a customer, send an API request to Razorpay with the bank account details to link the bank account to a customer. This allows Razorpay to tie the bank account with the particular Customer Id and thereby process a fund transfer initiated towards that account.
Refer to the
to make a payout.Was this page helpful?