Create Deposit Order (台灣)

CreateTWD (TWD)DepositOrder接口.

Request Information

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

Request Parameters

Parameter	Required	Type	Description
platform_id	Yes	String(7)	Merchant ID
service_id	Yes	String(7)	Service ID
payment_cl_id	Yes	String(32)	MerchantOrder號
amount	Yes	Integer(10)	Amount (分)
last_numbers	Yes	List of String	匯款帳號末五碼 (可輸入最小一組最多十組的帳號)
bank_code	No	String(3)	Bank代碼
name	Yes	String(32)	匯款人姓名
notify_url	Yes	String(256)	Transaction ResultNotificationURL
request_time	Yes	Integer(10)	Request Time (Seconds)
sign	Yes	String(32)	OrderSignature

Request Example

{
 "amount": 48389,
 "lastNumbers": [
  "12345",
  "67890",
  "11111"
 ],
 "notifyUrl": "http://localhost:54725/gateway/test-notification",
 "paymentClId": "test_tw_card_1766005863_25",
 "platformId": "PF0003",
 "requestTime": 1766005863,
 "serviceId": "SVC0025",
 "sign": "fd2b863acdb75d67fe938e33d4e56b02"
}

Response Example

Success Response

{
 "data": {
  "link": "http://localhost:8889/payment/index.html?token=eyJhbGciOiJ",
  "paymentInfo": {
   "amount": 48389,
   "displayAmount": 48389,
   "paymentClId": "test_tw_card_1766005863_25",
   "paymentId": "DEVPM00000018",
   "receiver": {
    "bankBranch": "",
    "bankLogo": "",
    "bankName": "臺灣企銀",
    "cardName": "test",
    "cardNumber": "12345666"
   },
   "token": "无须附言"
  }
 },
 "errorCode": "0000"
}

Error Response Example

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

Response Parameter Description

Parameter	Type	Description
error_code	String	Error Codes
error_msg	String	Error Message (error_code is not "0000" returned when )
link	String	OrderPayment URL

Remarks

• Merchant ID is Systemunique identifier assigned by, if not obtained, please contact Systempersonnel
• Service ID please enter:
• SVC0025 (ATM 支付)
• 更多請Refer to service_id List
• Transaction Amountunit is TWD (分)
• 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