跳到主要内容

創建收款單（印度）

創建印度盧比（INR）收款訂單接口。

請求資訊​

  • 請求 URL： /gateway/api/v1/payments
  • 請求方式： POST
  • Content-Type： application/json;charset=utf-8

請求參數​

參數名必選類型說明
platform_id是String(7)商戶 ID
service_id是String(7)服務 ID
payment_cl_id是String(32)商戶訂單號
amount是Integer(10)金額（分）
notify_url是String(256)交易結果通知地址
request_time是Integer(10)請求時間（秒）
sign是String(32)訂單簽名

請求示例​

{
  "amount": "50000",
  "name": "test_name",
  "notify_url": "https://xxx.xx/notification",
  "payment_cl_id": "DEVPM00014581",
  "platform_id": "PF0002",
  "request_time": "1595504136",
  "service_id": "SVC0030",
  "sign": "c81634c1769044eac9e9628a2292f557"
}

返回示例​

標準返回​

{
  "error_code": "0000",
  "data": {
    "link": "http://xxx.xxx.xx/gateway/portal/v1/payments/GqhJK1nePB%2FayV7EO9S1EQ%3D%3D"
  }
}

UPI 支付返回（額外返回 qr_code_url）​

{
  "error_code": "0000",
  "data": {
    "link": "https://dpay.a11in.online/api/payment_direct/redirect/DEVPM00000106",
    "payment_info": {
      "amount": 500000,
      "display_amount": 500000,
      "payment_id": "DEVPM00000106",
      "payment_cl_id": "test_1702032094_31",
      "qr_code_url": "upi://pay?pa=16510100057124@fdrl0001541.ifsc.npci&pn=16510100057124@fdrl0001541.ifsc.npci&tid=&mc=&tn=317250&am=5000.00&cu=INR",
      "upi": "ampedinternatioanl1@sbi",
      "token": "无须附言"
    }
  }
}

錯誤返回示例​

{
  "error_code": "0004",
  "error_msg": "验签错误!"
}

返回參數說明​

參數名類型說明
error_codeString錯誤碼
error_msgString錯誤訊息（error_code 不為 "0000" 時返回）
linkString訂單收銀地址
qr_code_urlStringUPI 支付地址

備註​

  • 商戶 ID 為系統分配之唯一識別，如尚未取得請聯繫系統人員
  • 服務 ID 請填入：
    • SVC0030（ATM 支付 - 印度通道）
    • SVC0031（UPI 支付 - 印度通道）
    • SVC0061（UPI 喚醒 - 印度通道）
    • 更多請參考 service_id 列表
  • 交易金額單位為印度盧比（分）
  • 請求時間使用 Unix timestamp，單位為秒
  • 交易結果將通知至 notify_url，請傳入可公開訪問之完整地址（僅支援 http 與 https 協議），參數規範見 交易結果通知