開發者
一次調用，一次回調，一條記錄
整套接入就是：一個您簽名的 REST 接口、一個您校驗的回調，以及一個隨時可以再查一次的狀態。
建立一筆支付
使用商戶密鑰以 HMAC-SHA256 對 path 簽名——注意中介軟件會去掉 /api 前綴，因此您簽名的是 /v2/payins，即使實際 POST 的是 /api/v2/payins。
示例程式碼使用 api.example.com——您的生產環境接口將在入駐時發放。
create-payment.sh
curl -X POST https://api.example.com/v2/payins \
-H "Content-Type: application/json" \
-H "X-API-Key: <your-api-key>" \
-H "X-Timestamp: <unix-timestamp>" \
-H "X-Signature: <hmac-sha256-of-path>" \
-d '{
"merchant_ref_id": "unique-order-ref-id-2025001",
"currency_code": "THB",
"request_amount": 1000,
"customer_id": "0198cbc6-fd02-7459-a671-78c306d0a1ad",
"customer_account_id": "0198cbc7-35ec-7c8c-8994-d3ac3e7f5255",
"redirect_url": "https://merchant.example.com/payment/success"
}'{
"id": "0198cbff-db9b-7b6a-9f82-6a55fdfb6575",
"merchant_ref_id": "unique-order-ref-id-2025001",
"status": "pending",
"request_amount": 1000,
"paypage_url": "https://pay.example.com/pay/0198cbff-db9b-7b6a-9f82-6a55fdfb6575"
}處理 Webhook——驗簽且冪等
我們會重試，直到您的伺服器返回 HTTP 200。簽名基於原始 body 計算，重新序列化已解析的 JSON 將無法匹配。
接口參考
API 一覽
| 接口 | 說明 |
|---|---|
| /v2/payins | 建立收款單（推薦） |
| /v1/payins/:id | 讀取單筆收款 |
| /v2/payins/:id/cancel | 取消待支付單 |
| /v1/payouts | 建立出款 |
| /v1/payouts/:id | 讀取單筆出款 |
| /v1/settlements | 結算至自有賬戶 |
| /v1/payins/:id/slip | 提交轉賬憑證 |
| /me/balances | 按幣種的餘額 |
| /me/limits | 您的結算與交易額度 |
| /me/issues | 提交與跟進問題 |
沙盒環境
為收款與出款提供專門的除錯接口，讓您在上線前完整跑通整條整合鏈路。