Tipos de dados e respostas comuns
Estes campos são usados em várias operações para as APIs de informações da conta e de banco de pontos.
Valor
Variáveis que indicam as recompensas de programas de fidelidade afetadas pela transação.
Campo | Descrição | Exemplo do valor | Obrigatório? |
---|---|---|---|
value | Valor da recompensa do programa de fidelidade, em pontos, milhas ou outra moeda do programa. | 100 | Sim |
currency | A moeda em que o resgate foi feito, por exemplo, reais, dólares americanos, pontos ou milhas, entre outras. | US$ | Sim |
DeclineReason
Motivos pelos quais uma transação pode ser recusada. Você também pode adicionar mensagens personalizadas para serem exibidas ao cliente.
reasonCode | Descrição | Código de status HTTP |
---|---|---|
ACCOUNT_INELIGIBLE | Conta não qualificada para a solicitação de resgate atual. | 200 |
ACCOUNT_NOT_FOUND | Conta para resgate não encontrada. | 200 |
COULD_NOT_FIND_THE_ORIGINAL_TRANSACTION | A transação original não foi encontrada. | 200 |
DUPLICATE_TRANSACTION | A solicitação de resgate foi recebida antes. | 200 |
INSUFFICIENT_BALANCE | Saldo insuficiente na conta do usuário. | 200 |
INVALID_AMOUNT | O valor do resgate não é válido. | 200 |
INVALID_PROMO_ID | O ID da promoção do resgate não é válido. | 200 |
Erros
Informações sobre erros para ajudar no registro e na investigação.
Respostas de erro
Campo | Descrição |
---|---|
status | Status de falha. |
requestId | Identificador exclusivo da solicitação. |
errorCode | Código de erro (consulte a tabela de códigos de erro para saber os valores). |
errorMessage | Mensagem de erro personalizada. |
additionalInfoMap | Lista de pares de valores-chave. |
Códigos de erro
Código do erro | Código de status 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 |