跳到主要内容

創建收款單（韓國）

創建韓圓（KRW）收款訂單接口。

請求資訊​

  • 請求 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)商戶訂單號
user_id否String(16)匯款人平台註冊用戶名
name否String(16)匯款人戶名
last_number否String(32)匯款人帳號
bank_name否String(32)匯款人銀行，銀行列表
amount是Integer(10)金額（分）
notify_url是String(256)交易結果通知地址
request_time是Integer(10)請求時間（秒）
sign是String(32)訂單簽名

請求示例​

{
  "amount": "130000000",
  "name": "테스",
  "user_id": "playerA",
  "notify_url": "https://xxx.xx/notification",
  "payment_cl_id": "DEVPM00014581",
  "platform_id": "PF0002",
  "request_time": "1595504136",
  "service_id": "SVC0026",
  "sign": "c81634c1769044eac9e9628a2292f557"
}

返回示例​

標準返回​

{
  "error_code": "0000",
  "data": {
    "link": "https://xxx.xxx.xx/gateway/portal/v1/payments/GqhJK1nePB",
    "register_link": "https://xxx.xxx.xx/gateway/register/v1/payments/GqhJK1ne"
  }
}

包含訂單資訊的返回​

{
  "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": "test_name",
        "card_number": "201408150955",
        "bank_name": "test_bank",
        "bank_branch": ""
      },
      "sender": {
        "card_name": "test_name",
        "card_number": "*************123456",
        "bank_name": "test_name"
      },
      "token": "26022"
    }
  }
}

錯誤返回示例​

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

返回參數說明​

參數名類型說明
error_codeString錯誤碼
error_msgString錯誤訊息（error_code 不為 "0000" 時返回）
linkString訂單收銀地址
register_linkString若匯款人為第一次使用通道，此連結為帳戶註冊地址，須依照指示完成註冊才可充值
amountInt提單金額

備註​

  • 商戶 ID 為系統分配之唯一識別，如尚未取得請聯繫系統人員
  • 服務 ID 請填入 SVC0026（ATM 支付），更多請參考 service_id 列表
  • 交易金額單位為韓圓（分），假使收款 10000，請乘以 100，傳入 1000000
  • 請求時間使用 Unix timestamp，單位為秒
  • 交易結果將通知至 notify_url，請傳入可公開訪問之完整地址（僅支援 http 與 https 協議），參數規範見 交易結果通知
重要提示

此通道僅供實名用戶收款，並且訂單將以實際到帳金額為主，接收結果時必須使用 real_amount 為實際上分欄位。