Respuestas y tipos de datos comunes
Estos campos se utilizan en distintas operaciones de las API Información de la cuenta y Banco de puntos.
Importe
Variables que indican las recompensas de fidelidad a las que afecta la transacción.
Campo | Descripción | Valor de muestra | ¿Obligatorio? |
---|---|---|---|
value | Importe de la recompensa de fidelidad, en puntos, millas u otra moneda del programa | 100,00 | Sí |
currency | La moneda en la que se realizó el canje, como CAD, USD, PUNTOS, MILLAS, etc. | USD | Sí |
DeclineReason
Razones por las que se rechazaría una transacción. También puedes añadir mensajes personalizados que se mostrarían al cliente.
reasonCode | Descripción | Código de estado HTTP |
---|---|---|
ACCOUNT_INELIGIBLE | Cuenta no apta para la solicitud de canje actual | 200 |
ACCOUNT_NOT_FOUND | No se ha encontrado la cuenta para el canje | 200 |
COULD_NOT_FIND_THE_ORIGINAL_TRANSACTION | No se ha encontrado la transacción original | 200 |
DUPLICATE_TRANSACTION | La solicitud de canje ya se ha recibido previamente | 200 |
INSUFFICIENT_BALANCE | Saldo insuficiente en la cuenta del usuario | 200 |
INVALID_AMOUNT | El importe del canje no es válido | 200 |
INVALID_PROMO_ID | El ID de la promoción de canje no es válido | 200 |
Errores
Información sobre errores para facilitar el registro y la investigación.
Respuestas de error
Campo | Descripción |
---|---|
status | Estado de fallo |
requestId | Identificador único de la solicitud |
errorCode | Código de error; consulta los valores en la tabla Códigos de error |
errorMessage | Mensaje de error personalizado |
additionalInfoMap | Lista de pares de claves/valores |
Códigos de error
Código del error | Código de estado 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 |