创建代收订单

创建商户代收订单，并返回收银台地址或 UPI Deeplink。

接口信息

• 方法：POST
• 路径：/v2/pay_in
• 认证：商户接口签名规则

业务参数

以下 JSON 编码后放入签名请求的 data 字段。

字段	类型	必填	说明
mch_order_no	string	是	商户订单号，不能为空
amount	string	是	订单金额，使用十进制字符串
user_id	string	是	商户侧用户 ID，不能为空
mode	int	否	1 收银台（默认），2 UPI Deeplink
notify_url	string	否	异步通知 URL，推荐传入；如未传则不会发起回调请求
return_url	string	否	支付完成后的返回 URL
data	object	是	支付方式及付款人信息
data.type	string	是	当前仅支持 upi
data.email	string	是	付款人邮箱
data.name	string	是	付款人姓名，不能为空
data.phone	string	是	印度手机号
data.pan_number	string	否	付款人 PAN 号；传入时不能为空

业务参数示例：

{
  "mch_order_no": "PI202607010001",
  "amount": "100.50",
  "user_id": "USER10001",
  "mode": 1,
  "notify_url": "https://merchant.example.com/notify/pay-in",
  "return_url": "https://merchant.example.com/payment/result",
  "data": {
    "type": "upi",
    "email": "payer@example.com",
    "name": "Test User",
    "phone": "9876543210",
    "pan_number": "ABCDE1234F"
  }
}

成功响应

兼容性说明：后续可能新增其他响应字段。接入方应忽略未识别字段，不要因出现文档外字段而解析失败。

收银台模式：

{
  "code": 0,
  "message": "ok",
  "data": {
    "order_no": "MPI123456789",
    "amount": "100.50",
    "type": "cashier",
    "url": "https://cashier.example.com/pay_in/cashier/MPI123456789"
  }
}

Deeplink 模式：

{
  "code": 0,
  "message": "ok",
  "data": {
    "order_no": "MPI123456789",
    "amount": "100.50",
    "type": "upi",
    "upi": "upi://pay?..."
  }
}

非生产环境的响应还可能包含 test_callback_url, 可根据该地址回调；生产环境不会返回该字段。