通用数据类型和响应
金额
表示受交易影响的会员奖励的变量。
| 字段 | 说明 | 示例值 | 是否必填？ |
|---|---|---|---|
value | 积分、里程或其他计划货币形式的会员奖励金额 | 100.00 | 是 |
currency | 兑换成的货币，如 CAD、USD，以及积分和里程等 | 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 |