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.

CampoDescriçãoExemplo do valorObrigatório?
valueValor da recompensa do programa de fidelidade, em pontos, milhas ou outra moeda do programa.100Sim
currencyA 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.

reasonCodeDescriçãoCódigo de status HTTP
ACCOUNT_INELIGIBLEConta não qualificada para a solicitação de resgate atual.200
ACCOUNT_NOT_FOUNDConta para resgate não encontrada.200
COULD_NOT_FIND_THE_ORIGINAL_TRANSACTIONA transação original não foi encontrada.200
DUPLICATE_TRANSACTIONA solicitação de resgate foi recebida antes.200
INSUFFICIENT_BALANCESaldo insuficiente na conta do usuário.200
INVALID_AMOUNTO valor do resgate não é válido.200
INVALID_PROMO_IDO 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

CampoDescrição
statusStatus de falha.
requestIdIdentificador exclusivo da solicitação.
errorCodeCódigo de erro (consulte a tabela de códigos de erro para saber os valores).
errorMessageMensagem de erro personalizada.
additionalInfoMapLista de pares de valores-chave.

Códigos de erro

Código do erroCódigo de status HTTP
ACCOUNT_NOT_FOUND4xx
AUTH_FAILED4xx
BAD_REQUEST4xx
INTERNAL_CONFIGURATION_ISSUE5xx
INVALID_ACCOUNT4xx
INVALID_CREDENTIALS4xx
REQUEST_IN_PROGRESS5xx
RESOURCE_NOT_FOUND4xx
TIMEOUT_ERROR5xx
TIMEOUT_ERROR_CODE5xx
UNKNOWN_ERROR_CODE5xx
Esta página foi útil?
Como podemos melhorar esse conteúdo?
Agradecemos por nos ajudar a melhorar.