Create Deposit Order (Thailand)

Create a THB (Thai Baht) deposit order.

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)	Merchant Order ID
amount	Yes	Integer(10)	Amount (in cents)
notify_url	Yes	String(256)	Transaction result notification URL
name	No	String(64)	Remitter name (required for real-name verification channels)
bank_name	Yes	String(6)	Remitter bank, required for SVC0044, SVC0045, SVC0046, SVC0065, refer to Bank List
last_number	No	String(6)	Remitter account number
request_time	Yes	Integer(10)	Request time (Unix timestamp in seconds)
sign	Yes	String(32)	Order Signature

Request Example

{
  "amount": "50000000",
  "bank_name": "KBANK",
  "last_number": "1234567890",
  "name": "test_name",
  "notify_url": "https://xxx.xx/notification",
  "payment_cl_id": "DEVPM00014581",
  "platform_id": "PF0002",
  "request_time": "1595504136",
  "service_id": "SVC0044",
  "sign": "c81634c1769044eac9e9628a2292f557"
}

Response Example

Success Response

{
  "error_code": "0000",
  "data": {
    "link": "http://xxx.xxx.xx/gateway/portal/v1/payments/GqhJK1nePB"
  }
}

Error Response Example

{
  "error_code": "0004",
  "error_msg": "Signature verification failed!"
}

Response Parameter Description

Parameter	Type	Description
error_code	String	Error code
error_msg	String	Error message (returned when error_code is not "0000")
link	String	Order payment URL
amount	Int	Submitted amount

Remarks

• Merchant ID is a unique identifier assigned by the system. If not obtained, please contact system personnel.
• Service ID options:
  • SVC0044 TrueMoney (Thailand channel)
  • SVC0045 Bank Gateway (Thailand channel)
  • SVC0046 Bank QR (Thailand channel)
  • SVC0065 PromptPay (Thailand channel)
  • Refer to Service ID List
• bank_name: refer to Bank List
• Transaction amount unit is THB (cents). Please multiply by 100. For example, to collect 10000.00, pass value 1000000
• Request time uses Unix timestamp in seconds
• Transaction results will be notified to notify_url. Please provide a publicly accessible full URL (only http and https protocols supported). See parameter specs in Transaction Result Notification