Initiate a Payment [v3]

Initiate a Payment [v3]

POST 
/api/v3/initiate-payment

Initiate a payment for an order after the customer has selected their payment mode and provided the required details. The response guides the subsequent payment flow — redirect for cards/netbanking, OTP for pay later, or QR for UPI.

Card PAN must be encrypted

For card payments, card details (card_no, cvv, expiry, card_holder_name) must be RSA-encrypted before submission. Raw card PAN data is not accepted.

Quick Reference

• Required: order_id, payment_mode_code, card_input_type
• Conditional: card details (card mode), upi_id (UPI), bank_code (netbanking), wallet_code (wallets), payment_flow (intent/collect/qr)
• Returns: transaction_id, payment_status, and next actions (redirect, complete_payment, show_qr, launch_upi_app, etc.)

Request

Responses

200

When the payment initiation is successful, the response will be as below

4XX

When the payment initiation is not successful, the response will be as below

5XX

When there is a problem on the server, the response will be as below