Payment Gateway Workflow
Given below is a complete end-to-end flow about how you can use Razorpay Payment Gateway.
1. Customer Places an Order
A customer visits your website or app, selects items they want to purchase and clicks the pay button to place an order. For each order placed by your customer, you create a transaction_id or checkout_id on your server for your reference. For example, #trn-345.
2. Create Order from Server
For each order placed by your customer, use the Razorpay Orders API to create an order from your server.
3. Order ID Returned
Razorpay processes the details sent and returns an order_id to you, for example, order_EKwxwAgItmmXdp. Map this order_id to the transaction_id #trn-345 you created in the first step. Know more about order states.
4. Pass Order ID to Checkout
Pass the order_id returned by Razorpay to your integration. This invokes the Razorpay Checkout, the client-side UI, which displays various payment methods.
5. Collect Payment Details
The customer selects a payment option to complete the payment. The payment details entered by the customer are secured and stored by Razorpay as tokens. The generated tokens are exchanged with your servers for further use.
6. Bank Authenticates the Payment
Razorpay sends an authentication request to the customer’s bank internally. After authentication, Razorpay is authorised to deduct the amount from the customer’s bank account.
For successful payments, the Checkout returns the razorpay_order_id, razorpay_payment_id and razorpay_signature.
Know more about payment states.
Payment Capture and Settlement
Once your customer completes the payment and Razorpay authenticates it, you must capture it automatically or manually. You can also verify the payment signature to ensure that the payment is received from an authentic source. Know more about payment capture settings.
After the payment is successfully captured, the amount is settled in your account according to your settlement cycle. Know more about settlements.
Refunds
Customers may claim refunds after the transaction. In such cases, you can initiate a refund, post which the funds are sent back to the customer’s account.
Test Cards
Use the test cards to test domestic payments, international payments and subscriptions.
Test Razorpay Checkout
Test the Checkout by clicking the PAY WITH RAZORPAY button.
- This initiates a 1 payment.
- Provide your phone number, email address, select your preferred payment method and complete the payment.
Live Transaction with Auto RefundThis is a real transaction and money will be deducted from your account. However, the amount debited will be auto-refunded to your account in 5-7 working days.
Next Step
Get started with Razorpay Payment Gateway integration.
