錯誤代碼一覽表

成功回應

情況	HTTP	本文
寫入成功	202	{"batch_id":"...","status":"ACCEPTED","record_count":200,"warnings":[]}
重複 batch_id	200	{"batch_id":"...","status":"ALREADY_RECEIVED"}
GET 成功	200	資料

Note

202 ACCEPTED 只代表已收下並通過格式驗證，不代表已入帳；入帳正確性以日結對帳結果為準。

錯誤格式

{
  "error": {
    "code": "INVALID_PAYLOAD",
    "message": "trade_records[3].total_amount must be a decimal string",
    "request_id": "8a1f3c2e-..."
  }
}

欄位	說明
code	錯誤代碼，程式判斷請用此欄位
message	英文說明，供除錯使用，內容可能變動
request_id	與 X-Request-Id header 相同，回報問題時請提供

錯誤代碼

HTTP	code	情況	合作夥伴處理
400	INVALID_PAYLOAD	格式、型別、必填、enum、小數位數錯誤	修正後重送（新 batch_id）
400	UNKNOWN_STANDARD_CODE	對照表中的 standard_code 不存在	修正後重送（新 batch_id）
400	BATCH_TOO_LARGE	筆數超過上限	拆批後重送（新 batch_id）
401	UNAUTHORIZED	未帶 API 金鑰或金鑰錯誤	檢查 x-functions-key header；金鑰若已更換請聯絡總部
403	FORBIDDEN	帳號尚未設定完成	聯絡總部
403	STORE_NOT_ALLOWED	store_id 不屬於該合作夥伴	聯絡總部
403	PARTNER_INACTIVE	合作夥伴帳號已停用	聯絡總部
404	NOT_FOUND	路徑或 code_type 不存在	檢查路徑
413	PAYLOAD_TOO_LARGE	請求本文超過 5 MB	拆小批次
429	RATE_LIMITED	超過每分鐘 120 次	依 Retry-After 等待後重試
500 / 503	SERVER_ERROR	伺服器暫時錯誤	指數退避重試，同一 batch_id

重試規則詳見冪等與重試。

警告代碼

警告不會造成拒收，會出現在寫入回應的 warnings 中。

code	情況
AMOUNT_MISMATCH	交易金額不符金額恆等式