跳到主要内容

建立收款單（台灣）

建立新台幣（TWD）收款訂單 API。

請求資訊​

  • 請求 URL： /gateway/api/v2/payments
  • 請求方式： POST
  • Content-Type： application/json;charset=utf-8

請求參數​

參數名稱必填型別說明
platform_id是String(6)商戶 ID
service_id是String(7)服務 ID
payment_cl_id是String(32)商戶訂單號
amount是Integer(10)金額（分）
name視服務String(16)匯款人戶名
bank_code視服務String(3)匯款人銀行代碼（3 碼），詳見匯款帳號說明
last_numbers視服務List of String匯款人帳號陣列（1～10 組），詳見匯款帳號說明
notify_url是String(256)交易結果通知地址
request_time是Integer(10)請求時間（秒）
sign_type否String(16)簽名類型，固定值 HMAC-SHA256
sign是String(32|64)訂單簽名

服務 ID 與欄位規則​

服務 ID名稱namelast_numbers
SVC0025ATM支付必填必填
SVC0090虛擬帳戶必填必填
SVC0083超商代碼建議填建議填
SVC0078一卡通免填免填
SVC0079全支付免填免填
SVC0080街口支付免填免填
SVC0085支付寶免填免填
  • name = 匯款人姓名；last_numbers = 匯款人帳號
  • 必填欄位未傳時，訂單會導入收銀台補填頁
  • SVC0083 未傳時系統會以預設值代入，建議帶真實值

匯款帳號 last_numbers 格式​

型別為陣列，一筆訂單可帶 1～10 組。兩種寫法都接受：

寫法範例說明
銀行代碼 + 帳號（建議）"013-699520035871"3 碼銀行代碼 + 半形連字號 + 帳號
純帳號"699520035871"1～20 碼數字；銀行代碼另用 bank_code 欄位帶入
  • SVC0090 需要銀行代碼，上述兩種寫法擇一
  • 銀行代碼為台灣財金公司 3 碼金融機構代號。例：004 台灣銀行、008 華南銀行、013 國泰世華、053 台中銀行、822 中國信託、824 連線銀行
  • 銀行名稱不需要傳，系統會依代碼自動補齊

請求範例​

SVC0025 ATM支付（需 last_numbers）​

{
  "platform_id": "DEMO01",
  "service_id": "SVC0025",
  "payment_cl_id": "order_20260112001",
  "amount": 10000,
  "name": "王小明",
  "last_numbers": [
    "013-699520035871",
    "822-193540226057"
  ],
  "notify_url": "https://merchant.example.com/notify",
  "request_time": 1768262400,
  "sign_type": "HMAC-SHA256",
  "sign": "d2e4..."
}

SVC0090 虛擬帳戶​

{
  "platform_id": "DEMO01",
  "service_id": "SVC0090",
  "payment_cl_id": "order_20260112003",
  "amount": 10000,
  "name": "王小明",
  "last_numbers": [
    "013-699520035871"
  ],
  "notify_url": "https://merchant.example.com/notify",
  "request_time": 1768262400,
  "sign_type": "HMAC-SHA256",
  "sign": "d2e4..."
}

帳號沒有銀行代碼前綴時，改用 bank_code 欄位帶入：

{
  "platform_id": "DEMO01",
  "service_id": "SVC0090",
  "payment_cl_id": "order_20260112004",
  "amount": 10000,
  "name": "王小明",
  "bank_code": "013",
  "last_numbers": [
    "699520035871"
  ],
  "notify_url": "https://merchant.example.com/notify",
  "request_time": 1768262400,
  "sign_type": "HMAC-SHA256",
  "sign": "d2e4..."
}

SVC0085 支付寶（欄位免填）​

{
  "platform_id": "DEMO01",
  "service_id": "SVC0085",
  "payment_cl_id": "order_20260112002",
  "amount": 10000,
  "notify_url": "https://merchant.example.com/notify",
  "request_time": 1768262400,
  "sign_type": "HMAC-SHA256",
  "sign": "d2e4..."
}

回傳範例​

成功回傳​

{
  "error_code": "0000",
  "data": {
    "link": "https://pay.example.com/cashier/DEMOPM0123456",
    "payment_id": "DEMOPM0123456",
    "payment_cl_id": "order_20260112001",
    "amount": 10000
  }
}

備註​

  • 交易金額單位為新台幣（分），請乘以 100 帶入
  • 請求時間使用 Unix timestamp，單位為秒
  • 交易結果將通知至 notify_url，參數規範請見 交易結果通知