通用資料類型和回應
金額
此變數表示受交易影響的會員獎勵。
| 欄位 | 詳情 | 範例值 | 是否為必要？ |
|---|---|---|---|
value | 會員獎勵金額 (以點數、里程數或其他計畫貨幣為單位) | 100.00 | 是 |
currency | 兌換所用的貨幣，例如 CAD、USD、POINTS、MILES 等 | USD | 是 |
DeclineReason
交易被拒絕的原因。您也可以新增會向旅客顯示的自訂訊息。
| reasonCode | 詳情 | HTTP 狀態碼 |
|---|---|---|
ACCOUNT_INELIGIBLE | 帳戶不符合目前兌換要求的資格 | 200 |
ACCOUNT_NOT_FOUND | 找不到用於兌換的帳戶 | 200 |
COULD_NOT_FIND_THE_ORIGINAL_TRANSACTION | 找不到原始交易 | 200 |
DUPLICATE_TRANSACTION | 之前已收到兌換要求 | 200 |
INSUFFICIENT_BALANCE | 使用者帳戶的餘額不足 | 200 |
INVALID_AMOUNT | 兌換金額無效 | 200 |
INVALID_PROMO_ID | 兌換促銷 ID 無效 | 200 |
錯誤
可協助記錄和調查的錯誤相關資訊。
錯誤回應
| 欄位 | 詳情 |
|---|---|
status | 失敗狀態 |
requestId | 不重複的要求識別碼 |
errorCode | 錯誤碼；請參閱「錯誤碼」表格中的值 |
errorMessage | 自訂錯誤訊息 |
additionalInfoMap | 機碼值組清單 |
錯誤碼
| 錯誤碼 | HTTP 狀態碼 |
|---|---|
ACCOUNT_NOT_FOUND | 4xx |
AUTH_FAILED | 4xx |
BAD_REQUEST | 4xx |
INTERNAL_CONFIGURATION_ISSUE | 5xx |
INVALID_ACCOUNT | 4xx |
INVALID_CREDENTIALS | 4xx |
REQUEST_IN_PROGRESS | 5xx |
RESOURCE_NOT_FOUND | 4xx |
TIMEOUT_ERROR | 5xx |
TIMEOUT_ERROR_CODE | 5xx |
UNKNOWN_ERROR_CODE | 5xx |