Pay-In · India

Request

The Pay-In API initiates collection transactions from customers. This page covers India (country code in). Request/response fields are the same across markets; use your market’s method codes only.

Request URL

Domain: Prefer unified host openapi.toppayment.com (path unchanged); legacy country domain (e.g. global-in-openapi.toppayment.com) remains available.

Environment	URL
Sandbox	https://openapi.toppayment.com/sandbox/in/pay/prePay
Production	https://openapi.toppayment.com/in/pay/prePay

method (Pay-In payment codes for India) is listed in Regional Payment Guide — India.

Request Header

Field	Required	Type	Description
Content-Type	M	String	Fixed value: application/json

Request Body

Field	Required	Type	Description
mchNo	M	String(32)	Merchant number
orderNum	M	String(64)	Merchant order number
amount	M	Number(32,8)	Transaction amount
productDetail	M	String(100)	Product detail
method	M	String(16)	Payment method (India) Required. Pass UPI — full list: Regional Payment Guide — India
timestamp	M	String(13)	Timestamp in milliseconds
customerName	M	String(64)	Customer name
customerEmail	M	String(64)	Customer email
customerPhone	M	String(32)	Customer phone
expiryPeriod	O	Number(1–9999)	Validity in minutes
downNotifyUrl	M	String(255)	Async callback URL
redirectUrl	O	String(512)	Redirect after payment
sign	M	String	Signature — see Signature

Request Body Example

Content-type: application/json

{
    "mchNo": "{{mchNo}}",
    "orderNum": "IN1234561",
    "amount": 1000,
    "productDetail": "Product",
    "method": "UPI",
    "timestamp": "1749451858772",
    "customerName": "Rajesh Kumar",
    "customerEmail": "[email protected]",
    "customerPhone": "9876543210",
    "expiryPeriod": 1440,
    "downNotifyUrl": "https://example.com/notify",
    "redirectUrl": "https://example.com/return",
    "sign": "Generate per signature rules and replace"
}

Response

HTTP Response

Field	Required	Type	Description
Content-Type	M	String	application/json

Response Body Parameters

Field	Required	Type	Description
success	M	Boolean	Success flag
code	M	String	9999 = success
msg	O	String	Message
timeStamp	M	Number	Server time (ms)
data	M	Object	Payload
method	M	String	Payment method (India) — Regional Payment Guide — India
…			(Same field list as the Philippines version)

{
    "success": true,
    "code": "9999",
    "msg": null,
    "timeStamp": 1767840272829,
    "data": {
        "orderNum": "IN1234561",
        "platOrderNum": "PRE2009093829059153920",
        "amount": 1000,
        "fee": 20.0,
        "method": "UPI",
        "productDetail": "Product",
        "customerName": "Rajesh Kumar",
        "customerEmail": "[email protected]",
        "customerPhone": "9876543210",
        "validTime": 1767926672819,
        "cashierUrl": "https://example.cashier/pay",
        "payData": "https://example.cashier/pay",
        "payDataType": "CASHIER_URL"
    }
}

Notification

Same callback contract as the Philippines Pay-In: body fields, status string values, and SUCCESS acknowledgment — see Transaction Status Codes.

Example callback (illustrative)

{
    "platOrderNum": "PRE2009165141186183168",
    "version": "v1",
    "orderNum": "IN12345621",
    "amount": 1000,
    "fee": 20,
    "customerName": "Rajesh Kumar",
    "customerEmail": "[email protected]",
    "customerPhone": "9876543210",
    "status": "SUCCESS",
    "sign": "…"
}

Respond with:

SUCCESS