Get IntentLink/QrCode with Split details

POST

/api/v0/order/{orderId}/upi

Initialises a UPI payment session for a given order. Returns both the UPI intent deep-links (GPay, PhonePe, Paytm, generic UPI) and a dynamic QR code in a single call. Optionally accepts split-settlement details that will be stored and automatically applied when the payment is captured via notify/enquiry.

Request

Path Params

Header Params

Body Params application/jsonRequired

Examples

Using Split Account IdUsing LabelSplit to Primary merchant account

{
  "splitSettlement": {
    "amountSplitType": "FLAT",
    "splitSettlementDetails": [
      {
        "splitAccountId": "SA001",
        "value": 300.00
      },
      {
        "splitAccountId": "SA002",
        "value": 200.00
      }
    ]
  }
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

cURL

Using Split Account IdUsing LabelSplit to Primary merchant account

curl --location 'https://olympus-pg-uat.enkash.in/api/v0/order//upi' \
--header 'Authorization: Bearer <token>' \
--header 'merchantAccessKey: <key>' \
--header 'Content-Type: application/json' \
--data '{
  "splitSettlement": {
    "amountSplitType": "FLAT",
    "splitSettlementDetails": [
      {
        "splitAccountId": "SA001",
        "value": 300.00
      },
      {
        "splitAccountId": "SA002",
        "value": 200.00
      }
    ]
  }
}'

Responses

🟢200Success

application/json

Bodyapplication/json

Example

{
  "response_code": 0,
  "response_message": "SUCCESS",
  "payload": {
    "transactionId": "EKP20240601123456789",
    "intentLinkDetail": {
      "gpay": "gpay://upi/pay?pa=merchant%40bank&pn=MerchantName&am=500.00&cu=INR&tid=EKP20240601123456789",
      "phonepe": "phonepe://pay?pa=merchant%40bank&pn=MerchantName&am=500.00&cu=INR&tid=EKP20240601123456789",
      "paytm": "paytmmp://pay?pa=merchant%40bank&pn=MerchantName&am=500.00&cu=INR&tid=EKP20240601123456789",
      "upi": "upi://pay?pa=merchant%40bank&pn=MerchantName&am=500.00&cu=INR&tid=EKP20240601123456789"
    },
    "qrCode": {
      "qrCode": "iVBORw0KGgoAAAANSUhEUgAA...<base64-encoded PNG>",
      "qrUrl": "upi://pay?pa=merchant%40bank&pn=MerchantName&am=500.00&cu=INR&tid=EKP20240601123456789",
      "qrUrlType": "PAY"
    }
  }
}

🟠400Bad Request

Modified at 2026-06-12 04:17:06

Edit Or Deferred Split Settlement

UPI QR