Skip to main content
POST
/
pg
/
subscriptions
/
intent
Create UPI Subscription (Intent Flow)
curl --request POST \
  --url https://api-pacb-uat.eximpe.com/pg/subscriptions/intent/ \
  --header 'Content-Type: application/json' \
  --header 'X-API-Version: <api-key>' \
  --header 'X-Client-ID: <api-key>' \
  --header 'X-Client-Secret: <api-key>' \
  --header 'X-Merchant-ID: <api-key>' \
  --data '
{
  "amount": "1000.00",
  "collection_mode": "s2s",
  "currency": "INR",
  "reference_id": "SUBGB37NP",
  "buyer": {
    "name": "John Doe",
    "email": "[email protected]",
    "phone": "+919876543210",
    "address": {
      "line_1": "123 Main Street",
      "line_2": "Apt 4B",
      "city": "Mumbai",
      "state": "Maharashtra",
      "postal_code": "400001"
    },
    "ip_address": "192.168.1.100",
    "user_agent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/91.0.4472.124 Safari/537.36"
  },
  "product": {
    "name": "Monthly Subscription Plan",
    "description": "Monthly subscription for premium services",
    "hs_code": "98051000",
    "hs_code_description": "Subscription services",
    "type_of_goods": "service"
  },
  "invoice": {
    "number": "INVPUZWBY",
    "date": "2025-12-15"
  },
  "standing_instruction": {
    "billing_amount": "1000.00",
    "billing_currency": "INR",
    "billing_cycle": "MONTHLY",
    "billing_interval": 1,
    "payment_start_date": "2026-01-15",
    "payment_end_date": "2027-01-15",
    "remarks": "Monthly subscription for premium services",
    "auto_refund_mandate": false
  },
  "mop_type": "UPI",
  "upi_flow_type": "intent"
}
'
{
  "success": true,
  "message": "UPI Subscription created successfully",
  "data": {
    "order_id": "550e8400-e29b-41d4-a716-446655440000",
    "subscription_id": "660e8400-e29b-41d4-a716-446655440001",
    "subscription_type": "UPI_RECURRING",
    "intent_uri": "pa=merchant@payu&pn=Merchant%20Name&am=1000.00&cu=INR&tn=Order%20Description&tr=ORD-2024-001",
    "qr_code": {
      "url": "upi://pay?pa=merchant@payu&pn=Merchant%20Name&am=1000.00&cu=INR&tn=Order%20Description&tr=ORD-2024-001",
      "base64": "iVBORw0KGgoAAAANSUhEUgAA..."
    },
    "subscription": {
      "billing_cycle": "MONTHLY",
      "billing_interval": 1,
      "payment_start_date": "2024-01-01",
      "payment_end_date": "2024-12-31"
    }
  }
}

Documentation Index

Fetch the complete documentation index at: https://docs.eximpe.com/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

​
X-Client-ID
string
header
required

Client Application ID - Your unique application identifier used to authenticate API requests. You can find your Client ID in the Developer Settings section of the merchant dashboard.

​
X-Client-Secret
string
header
required

Client Secret Key - Your secret key used alongside the Client ID for secure authentication. Keep this confidential and never expose it in client-side code. Available in the Developer Settings section of the merchant dashboard.

​
X-Merchant-ID
string
header
required

Merchant Identifier - The unique ID for the merchant account. This is required for PSP (Payment Service Provider) merchants who manage multiple merchant accounts. You can find merchant IDs in the Merchant Management section of the dashboard.

​
X-API-Version
string
header
required

API Version - Specifies which version of the API to use (e.g., '2.X.X'). This header allows you to control which API version your integration uses.

Body

application/json

Subscription creation request with INTENT flow. Requires preferred_upi_flow_type to be 'INTENT'.

​
amount
string
required

Order amount

​
currency
string
required

Currency code (e.g. INR)

​
reference_id
string
required

Unique merchant reference ID

​
buyer
object
required

Buyer details

​
product
object
required

Product details

​
invoice
object
required

Invoice details

​
standing_instruction
object
required

Standing instruction configuration for a subscription

​
collection_mode
enum<string>

Payment collection mode (must be 's2s' for subscriptions)

Available options:
s2s
​
mop_type
enum<string>

Method of payment

Available options:
UPI
​
upi_flow_type
enum<string>

UPI flow type (must be 'intent')

Available options:
intent

Response

UPI Subscription created successfully

​
success
boolean
required
​
message
string
required
​
data
object
required