跳至主要内容

創建收款單（人民幣）

創建人民幣收款訂單接口。

請求資訊​

  • 請求 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)交易結果通知地址
name否String(16)匯款人戶名（實名制渠道必填）
last_number否String(6)匯款人帳戶末六碼
request_time是Integer(10)請求時間（秒）
sign是String(32)訂單簽名

請求示例​

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

返回示例​

銀行卡代收​

{
  "error_code": "0000",
  "data": {
    "link": "http://xxx.xxx.xx/gateway/portal/v1/payments/GqhJK1nePB",
    "payment_info": {
      "amount": 50000,
      "display_amount": 49996,
      "payment_id": "PM00161864",
      "payment_cl_id": "DEVPM00014581",
      "receiver": {
        "card_name": "測試代收卡01",
        "card_number": "201408150955",
        "bank_name": "中国建设银行",
        "bank_branch": "測試代收卡01",
        "bank_logo": "https://apimg.alipay.com/combo.png?d=cashier&t=CCB"
      },
      "sender": {
        "card_name": "test_name",
        "card_number": "*************123456",
        "bank_name": "中国农业银行",
        "bank_logo": "https://apimg.alipay.com/combo.png?d=cashier&t=ABC",
        "bank_link": "https://perbank.abchina.com/EbankSite/startup.do?r=6CD8F48924CC703B"
      },
      "token": "26022"
    }
  }
}

支付寶收款​

重要提示

使用支付寶的商戶將隨機收到支付寶轉帳或掃碼模式的返回，串接時需要能適應這兩種返回格式。

返回以下欄位其中之一：

  • qr_code_url（二維碼內容）有返回 → 支付寶掃碼
  • account_code（支付寶帳號）、account_name（支付寶暱稱）有返回 → 支付寶轉帳
{
  "error_code": "0000",
  "data": {
    "link": "https://demo.payment.com/index.html",
    "payment_info": {
      "amount": 273081,
      "display_amount": 273081,
      "payment_id": "KUITECPM02239985",
      "payment_cl_id": "test_1706530149_10",
      "token": "无须附言",
      "account_code": "2827147939@qq.com",
      "account_name": "郭",
      "qr_code_url": "https://qr.alipay.com/tsx11102hlw8nncztyzu9e0"
    }
  }
}

微信收款（掃碼模式）​

重要提示

使用微信將隨機返回以下四種支付碼，欄位可能為選填。

返回以下欄位其中之一：

  • qr_code_url（二維碼內容）有返回 → 微信掃碼
  • account_code（微信帳號/號碼/支付碼）、account_name（微信暱稱）有返回 → 微信轉帳
{
  "error_code": "0000",
  "data": {
    "link": "https://demo.payment.com/index.html",
    "payment_info": {
      "amount": 273081,
      "display_amount": 273081,
      "payment_id": "KUITECPM02239985",
      "payment_cl_id": "test_1706530149_10",
      "token": "无须附言",
      "account_code": "18857799168",
      "account_name": "叶小国",
      "qr_code_url": "https://qr.alipay.com/tsx11102hlw8nncztyzu9e0"
    }
  }
}

錯誤返回示例​

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

返回參數說明​

參數名類型說明
error_codeString錯誤碼
error_msgString錯誤訊息（error_code 不為 "0000" 時返回）
linkString訂單收銀地址
amountInt提單金額
display_amountInt浮動後須支付金額

備註​

  • 商戶 ID 為系統分配之唯一識別，如尚未取得請聯繫系統人員
  • 服務 ID 請填入：
    • SVC0001（銀行卡代收）
    • SVC0008（微信掃碼）
    • SVC0010（支付寶掃碼）
    • 更多請參考 service_id 列表
  • 銀行 ID 可傳入 bank_id 也可使用 bank_code，請查 銀行列表
  • 交易金額單位為人民幣（分）
  • 請求時間使用 Unix timestamp，單位為秒
  • 交易結果將通知至 notify_url，請傳入可公開訪問之完整地址（僅支援 http 與 https 協議），參數規範見 交易結果通知