Submit Payment Detail

POST

/api/v0/payment/submit

order-controller

Request

Header Params

Authorization

string

required

merchantAccessKey

string

required

Body Params application/json

orderId

string

required

paymentDetail

object (PaymentDetailDTO)

optional

paymentMode

enum<string> | enum<null>

required

Allowed values:

NET_BANKINGUPICREDIT_CARDDEBIT_CARDPREPAID_CARDPAY_LATERWALLETCORPORATE_CARD

cardHolderName

string

optional

Required for Cards Payment Mode

cardNumber

string

optional

Required for Cards Payment Mode

cvv

string

optional

Required for Cards Payment Mode

expiry

string

optional

Required for Cards Payment Mode

bankCode

string

optional

Required for NetBanking, BNPL, Wallet Payment Modes

bnplPaymentOptionId

string

optional

Required for BNPL Payment Mode

vpa

string

optional

Required for UPI Payment Mode

accountNumber

string

optional

Required for UPI TPV flow

>= 9 characters<= 36 characters

ifsc

string | null

optional

Required for UPI TPV flow

>= 11 characters<= 11 characters

Example:

KKBK0000727

Match pattern:

^[A-Z]{4}0[A-Z0-9]{6}$

Example

{
  "orderId": "string",
  "paymentDetail": {
    "paymentMode": "NET_BANKING",
    "cardHolderName": "string",
    "cardNumber": "string",
    "cvv": "string",
    "expiry": "string",
    "bankCode": "string",
    "bnplPaymentOptionId": "string",
    "vpa": "string"
  }
}

Request samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST '/api/v0/payment/submit' \
--header 'Authorization;' \
--header 'merchantAccessKey;' \
--header 'Content-Type: application/json' \
--data-raw '{
  "orderId": "string",
  "paymentDetail": {
    "paymentMode": "NET_BANKING",
    "cardHolderName": "string",
    "cardNumber": "string",
    "cvv": "string",
    "expiry": "string",
    "bankCode": "string",
    "bnplPaymentOptionId": "string",
    "vpa": "string"
  }
}'

Responses

🟢200OK

application/json

Body

response_code

integer <int32>

optional

response_message

string

optional

payload

object (OrderPaymentSubmitResponse)

optional

redirectionUrl

string

optional

transactionId

string

optional

Example

{
    "response_code": 0,
    "response_message": "string",
    "payload": {
        "redirectionUrl": "string",
        "transactionId": "string"
    }
}

Get Transaction Status

About Refund