Skip to main content

Create Deposit Order (韓國)

Create韓圓 (KRW)DepositOrder接口.

Request Information

  • **Request URL: ** /gateway/api/v1/payments
  • **Request Method: ** POST
  • **Content-Type: ** application/json;charset=utf-8

Request Parameters

ParameterRequiredTypeDescription
platform_idYesString(7)Merchant ID
service_idYesString(7)Service ID
payment_cl_idYesString(32)MerchantOrder號
user_idNoString(16)匯款人平台註冊用戶名
nameNoString(16)Remitter Name
last_numberNoString(32)匯款人帳號
bank_nameNoString(32)匯款人Bank, BankList
amountYesInteger(10)Amount (分)
notify_urlYesString(256)Transaction ResultNotificationURL
request_timeYesInteger(10)Request Time (Seconds)
signYesString(32)OrderSignature

Request Example

{
"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"
}

Response Example

標準Return

{
"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"
}
}

包含Order資訊的Return

{
"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 Response Example

{
"error_code": "0004",
"error_msg": "Signature Verification Failed!"
}

Response Parameter Description

ParameterTypeDescription
error_codeStringError Codes
error_msgStringError Message (error_code is not "0000" returned when )
linkStringOrderPayment URL
register_linkString若匯款人is 第一次uses Channel, 此連結is 帳戶註冊URL, 須依照指示完成註冊才可充Value
amountIntSubmissionAmount

Remarks

  • Merchant ID is Systemunique identifier assigned by, if not obtained, please contact Systempersonnel
  • Service ID please enter SVC0026 (ATM 支付), 更多請Refer to service_id List
  • Transaction Amountunit is 韓圓 (分), 假使Deposit 10000, please multiply by 100, pass in 1000000
  • Request Timeuses Unix timestamp, unit is Seconds
  • Transaction Result將Notification至 notify_url, 請pass in 可公開訪問之完整URL (僅supports http 與 https protocol), see parameter specs in Transaction ResultNotification
Important Notice

此Channel僅供實名用戶Deposit, 並且Order將以實際到帳Amountis 主, 接收結果時必須uses real_amount is 實際上分欄位.