Status da transação e códigos de resposta

Cada pagamento tem uma ou mais transações associadas. A documentação a seguir aborda os tipos de transação, os códigos de status e as descrições depois que um status HTTP 200 é obtido e uma transação é processada.

Fluxo de trabalho

Tipos de transações

Tipo	Descrição
`PURCHASE`	Uma transação de compra direta.
`AUTHORIZE`	Transação associada à autorização. Principalmente para pagamentos com cartão.
`CAPTURE`	Uma captura de uma transação previamente autorizada.
`REFUND`	Um reembolso de uma transação previamente aprovada.
`CANCEL`	Um cancelamento de uma transação pendente anteriormente.
`VERIFY`	Transação associada a uma verificação de cartão de crédito.
`CHARGEBACK`	Transação associada a um estorno.
`THREE_D_SECURE`	Uma transação de verificação 3DS para uma compra inicial.
`FRAUD_SCREENING`	A triagem de fraudes está associada à verificação de fraudes.

Códigos de transação

A cada transação, você receberá um response_code detalhando mais informações sobre ele. Os detalhes relacionados a cada status são apresentados abaixo. Use os botões a seguir para navegar até o conteúdo desejado.

Status de sucesso

Status de ganho

Status criado

Status pendente

Status recusado

Status rejeitado

Status do erro

Status expirado

Status perdido

Status impedido

Status de sucesso

SUCCEEDED Detalhes do status

código_de_resposta	Descrição	Declínio rígido/suave	Código ISO 8583
`SUCCEEDED`	Transação bem-sucedida	N/A	0,8,10,11,16,32
`FRAUD_VERIFIED`	Transação verificada pelo provedor de fraude	N/A	-
`SUCCEEDED_THREE_D_SECURE`	Validação 3DS bem-sucedida	N/A	-

Status de ganho

WON Detalhes do status

código_de_resposta	Descrição	Declínio rígido/suave	Código ISO 8583
`REVIEW_WON`	O adquirente rejeitou o estorno	N/A	-

Status criado

CREATED Detalhes do status

código_de_resposta	Descrição	Declínio rígido/suave	Código ISO 8583
`ACTION_REQUIRED`	Pagamento criado, mas requer ação adicional do usuário. Isso ocorre em fluxos de autenticação 3D Secure, redirecionamentos de métodos de pagamento, fluxos Headless SDK que exigem continuePayment ou métodos de pagamento assíncronos com etapas adicionais. Verifique o `redirect_url` ou `sdk_action_required` campo para as próximas etapas.	N/A	-
`SUCCEEDED`	Transação criada com sucesso	N/A	-
`RECEIVED`	Transação recebida	N/A	-

Status pendente

PENDING Detalhes do status

código_de_resposta	Descrição	Declínio rígido/suave	Código ISO 8583
`CHALLENGE_REQUIRED`	Transação aguardando a conclusão do desafio	N/A	-
`IN_REVIEW`	A documentação do estorno foi enviada ao provedor e está sendo analisada	N/A	-
`PENDING_FRAUD_REVIEW`	A transação está sendo analisada pelo provedor de fraudes	N/A	-
`PENDING_PROVIDER_CONFIRMATION`	Transação aguardando confirmação	N/A	-
`PENDING_REVIEW`	Transação aguardando confirmação de revisão de fraude	N/A	-

Status recusado

📘
Alguns declínios incluem merchant_advice_code (MAC) que indica se e quando tentar novamente. Veja Merchant Advice Codes (MAC).

DECLINED Detalhes do status

código_de_resposta	Descrição	Declínio rígido/suave	Código ISO 8583
`ACCOUNT_STATUS`	Entre em contato com o provedor de fraudes para verificar o status da sua conta.	N/A	-
`ACQUIRE_CONTINGENCY`	Serviço de aquisição indisponível	SUAVE	22, 80, 90, 91, 92, 96
`AUTHENTICATION_ATTEMPT`	Tentativa de autenticação sem conclusão	N/A	-
`AUTHENTICATION_FAILED_THREE_D_SECURE`	Falha na validação 3D	N/A	-
`BAD_FILLED_INFO`	O cartão não corresponde aos parâmetros do emissor	DURO	30,89
`BANK_NOT_SUPPORTED`	Banco não suportado pela chave	SUAVE	31
`CALL_FOR_AUTHORIZE`	O aceitador do cartão liga para o departamento de segurança do adquirente	SUAVE	66
`CANCELLED_BY_USER`	Cancelado pelo usuário	SUAVE	17
`COUNTRY_NOT_SUPPORTED`	Essa transação não pode ser processada devido a um país não suportado	DURO	-
`CURRENCY_NOT_ALLOWED`	Moeda não permitida	DURO	-
`DECLINED_BY_BANK`	Rejeitado pelo banco. Consulte o emissor do cartão	SUAVE	-
`DECLINED_BY_PROVIDER`	Rejeitado pelo provedor. Consulte os dados do provedor	SUAVE	-
`DISABLED`	Cartão restrito	SUAVE	-
`DO_NOT_HONOR`	Não honrar	SUAVE	5
`DUPLICATED_TRANSACTION`	Transmissão duplicada da transação	SUAVE	26,94
`EXPIRED`	Método de pagamento alternativo expirado	SUAVE
`EXPIRED_CARD`	Cartão expirado	DURO	33,54
`FIRST_USE`	Primeiro uso bloqueado	SUAVE	78
`FRAUD_VALIDATION`	Violação de segurança	SUAVE	34, 59, 63, 64
`FRAUD_VERIFICATION_DECLINED`	-	-	-
`INSUFFICIENT_FUNDS`	Fundos insuficientes	SUAVE	51
`INVALID_AMOUNT`	Valor inválido	SUAVE	13,64
`INVALID_CARD_DATA`	O cartão não corresponde aos parâmetros do emissor.	DURO	56
`INVALID_CARD_NUMBER`	O cartão não corresponde aos parâmetros do emissor.	DURO	14
`INVALID_API`	Tentativa de verificar o pagamento com um endereço IP não autorizado	DURO	-
`INVALID_API_VERSION`	Versão inválida da API	DURO	-
`INVALID_CREDENTIALS`	Credenciais inválidas do provedor de fraude definidas no Yuno.	DURO	-
`INVALID_ISSUER`	Emissor inválido	SUAVE	15
`INVALID_MERCHANT`	Comerciante ou provedor de serviços inválido	SUAVE	3
`INVALID_PARAMETERS`	Parâmetros inválidos	DURO	-
`INVALID_SECURITY_CODE`	Código de segurança do cartão inválido	DURO	56,82
`INVALID_STATUS`	Status inválido	SUAVE	-
`INVALID_RESPONSE_FORMAT`	O corpo da resposta retornado pelo provedor tem um formato inválido	SUAVE	-
`INVALID_TRANSACTION`	A transação que está sendo tentada é inválida	DURO	12,23
`ISSUER_VIOLATION`	O banco emissor rejeitou a transação devido a alguma violação relacionada à conta.	SUAVE	93
`MISSING_PARAMETERS`	Parâmetros ausentes	DURO	-
`NO_RETRY_LIFE_CYCLE`	Sem ciclo de vida de novas tentativas	DURO	79
`NO_RETRY_POLICY`	Política de não repetição	DURO	82
`NO_RETRY_SECURITY`	Sem segurança de nova tentativa	DURO	83
`RETRY_AFTER_1_H`	Repetir após 1 hora	DURO
`RETRY_AFTER_24_H`	Repetir após 24 horas	DURO
`RETRY_AFTER_2_D`	Repetir após 2 dias	DURO
`RETRY_AFTER_4_D`	Repetir após 4 dias	DURO
`RETRY_AFTER_6_D`	Repetir após 6 dias	DURO
`RETRY_AFTER_8_D`	Repetir após 8 dias	DURO
`RETRY_AFTER_10_D`	Repetir após 10 dias	DURO
`REJECTED_THREE_D_SECURE_REQUIRED`	Rejeição da validação 3DS	SUAVE	-
`REFER_TO_CARD_ISSUER`	Rejeitado pelo banco. Consulte o emissor do cartão	SUAVE	01
`REPORTED_LOST`	Cartão perdido	DURO	41
`REPORTED_STOLEN`	Cartão roubado, retirada	DURO	43
`REQUESTS_EXCEEDED`	Limite de solicitações para a conta do provedor atingido.	SUAVE	-
`RESTRICTED_BY_BANK`	Rejeitado pelo banco. Consulte as condições especiais do emissor do cartão	SUAVE	62
`TERMINAL_ERROR`	Sua conta de comerciante não está configurada corretamente para a transação	SUAVE	58
`THREE_D_SECURE_REQUIRED`	O provedor antifraude exige um desafio 3DS para validação adicional.	SUAVE
`TRANSACTION_NOT_FOUND`	Transação não encontrada	DURO	25
`UNAVAILABLE_PAYMENT_METHOD`	A função solicitada não é compatível	DURO	-
`UNSUPPORTED_OPERATION`	A função solicitada não é compatível	DURO	40
`UNKNOWN_ERROR`	Erro desconhecido	SUAVE	-
`USER_RESTRICTION`	Transação não permitida para o titular do cartão	DURO	57

Merchant Advice Codes (MAC)

Esses códigos fornecerão orientações úteis ao lidar com transações recusadas. Você pode encontrar esses campos em nossas respostas públicas de API:

transactions.merchant_advice_code e transactions.merchant_advice_code_message: Campos unonormalizados que fornecem códigos padronizados e explicações sobre a negação.
transactions.provider_data.merchant_advice_code e transactions.merchant_advice_code_message: Código bruto e mensagem do provedor.

Consulte Merchant Advice Codes (MAC) para obter mais informações.

Merchant Advice Codes (MAC)

Os Merchant Advice Codes fornecem orientação dos emissores/fornecedores sobre o comportamento e a política de novas tentativas. Quando presente em uma recusa, use o MAC para determinar se deve tentar novamente e o tempo recomendado.

código de aconselhamento do comerciante	Descrição	Código MAC do provedor
`UPDATE_INFORMATION`	Informações atualizadas/adicionais necessárias	01 - Informações atualizadas sobre a conta disponíveis
`TRY_AGAIN_LATER`	Repetir após 10 dias	02 - Tente novamente mais tarde
`DO_NOT_TRY_AGAIN`	Não tente novamente	03 - Não tente novamente
`REQUIREMENTS_NOT_FULFILLED`	Requisitos Token não atendidos	04 - Requisitos Token não atendidos
`NO_RETRY_LIFE_CYCLE`	Sem ciclo de vida de novas tentativas	21 - Plano recorrente cancelado
`RETRY_AFTER_1_H`	Repetir após 1 hora	24 - Nova tentativa após 1 hora (fundos insuficientes)
`RETRY_AFTER_24_H`	Repetir após 24 horas	25 - Nova tentativa após 24 horas (fundos insuficientes)
`RETRY_AFTER_2_D`	Repetir após 2 dias	26 - Repetir após 2 dias (fundos insuficientes)
`RETRY_AFTER_4_D`	Repetir após 4 dias	27 - Repetir após 4 dias (fundos insuficientes)
`RETRY_AFTER_6_D`	Repetir após 6 dias	28 - Nova tentativa após 6 dias (fundos insuficientes)
`RETRY_AFTER_8_D`	Repetir após 8 dias	29 - Nova tentativa após 8 dias (fundos insuficientes)
`RETRY_AFTER_10_D`	Repetir após 10 dias	30 - Nova tentativa após 10 dias (fundos insuficientes)
`NO_RETRY_POLICY`	Política de não repetição	40 - Cartão pré-pago não recarregável
`NO_RETRY_SECURITY`	Sem segurança de nova tentativa	42 - Pontuação da sanção excedida
`MULTIPLE_USE_CARD`	Cartão virtual de uso múltiplo	43 - Cartão virtual de uso múltiplo

Status rejeitado

REJECTED Detalhes do status

código_de_resposta	Descrição	Declínio rígido/suave	Código ISO 8583
`COUNTRY_NOT_SUPPORTED`	-	DURO	-
`CURRENCY_NOT_ALLOWED`	-	DURO	-
`INVALID_PARAMETERS`	-	DURO	-
`INVALID_REQUEST`	-	DURO	-
`INTERNAL_ERROR`	-	DURO	-
`MISSING_PARAMETERS`	-	DURO	-

Status do erro

ERROR Detalhes do status

código_de_resposta	Descrição	Declínio rígido/suave	Código ISO 8583
`ERROR`	Erro interno desconhecido	SUAVE	-
`PROVIDER_ERROR`	Erro. Ocorreu um erro desconhecido durante a autorização	SUAVE	6
`PROVIDER_INTERNAL_ERROR`	Erro interno	SUAVE	98
`PROVIDER_INVALID_CREDENTIALS`	Credenciais inválidas	DURO	-
`PROVIDER_INVALID_REQUEST`	Solicitação inválida	DURO	-
`PROVIDER_TIMEOUT`	Resposta recebida muito tarde	SUAVE	68
`PROVIDER_UNKNOWN_ERROR`	Erro desconhecido	SUAVE	-
`OPERATION_NOT_SUPPORTED`	O provedor não é compatível com essa operação	DURO	-
`TO_REVERSE`	A transação será estornada	DURO	-
`PROVIDER_INVALID_RESPONSE`	Resposta inválida	DURO	20
`PROVIDER_INVALID_API_VERSION`	Versão inválida da API	DURO	-

Status expirado

EXPIRED Detalhes do status

código_de_resposta	Descrição	Declínio rígido/suave	Código ISO 8583
`EXPIRED_BY_PROVIDER`	-	N/A	-

Status perdido

LOST Detalhes do status

código_de_resposta	Descrição	Declínio rígido/suave	Código ISO 8583
`CLOSED`	-	N/A	-
`EXPIRED`	-	N/A	-
`PARTIALLY_CHARGEBACKED`	-	N/A	-
`REVIEW_LOST`	A disputa de estorno foi perdida	N/A	-

Status impedido

PREVENTED Detalhes do status

código_de_resposta	Descrição	Declínio rígido/suave	Código ISO 8583
`PREVENTED`	Pré-disputa desviada pelo provedor/rede. Não são necessárias provas. Terminal.	N/A	-

Observação

PREVENTED só é aplicável a transações com type = CHARGEBACK quando o provedor/rede indica uma deflexão pré-disputa. Nesses cenários, o Yuno emite apenas o webhook de estorno; nenhum webhook de reembolso é enviado.

Códigos de resposta específicos de estornos

Para obter mais detalhes, consulte a página de códigos de motivos na seção Guias de estorno.

CREATED Detalhes do status

código_de_resposta	mensagem_de_resposta	Categoria	Descrição
`EMV_LIABILITY_SHIFT_COUNTERFEIT`	Mudança de responsabilidade EMV Fraude de falsificação	Fraude	O titular do cartão está alegando que não autorizou ou não participou de uma transação que você processou.
`EMV_LIABILITY_SHIFT_NOT_COUNTERFEIT`	Mudança de responsabilidade EMV Fraude não falsificada	Fraude	O titular do cartão está alegando que não autorizou ou não participou de uma transação que você processou.
`CARD_PRESENT_FRAUD`	Outras fraudes - ambiente de cartão-presente	Fraude	O titular do cartão está alegando que não autorizou nem participou de uma transação digitada com chave ou não assistida realizada em um ambiente com cartão presente.
`NON_CARD_PRESENT_FRAUD`	Outras fraudes - ambiente sem cartão	Fraude	O titular do cartão não autorizou nem participou de uma transação realizada em um ambiente sem cartão presente, como internet, pedidos por correio, pedidos por telefone e outros.
`SCHEME_MONITORING_PROGRAM`	Outras fraudes - Programa de monitoramento de esquemas	Fraude	Programa de monitoramento de fraudes de esquemas
`NO_AUTHORIZATION`	Sem autorização	Autorização	A autorização correta e válida não foi obtida pelo comerciante.
`DECLINED_AUTHORIZATION`	Autorização recusada	Autorização	A solicitação de autorização recebeu uma resposta de recusa e o comerciante concluiu a transação.
`LATE_PRESENTMENT`	Apresentação tardia	Erros de processamento	A transação não foi enviada à Visa dentro do prazo exigido.
`INCORRECT_TRANSACTION_CODE`	Código de transação incorreto	Erros de processamento	O titular do cartão está alegando que o valor convertido da cobrança em uma transação internacional está incorreto.
`INCORRECT_CURRENCY`	Moeda incorreta	Erros de processamento	O comerciante cometeu um ou mais erros relacionados à moeda da transação
`INCORRECT_ACCOUNT_NUMBER`	Número de conta incorreto	Erros de processamento	O número da conta na autorização não corresponde ao número da conta usado na transação.
`INCORRECT_AMOUNT`	Valor incorreto	Erros de processamento	O titular do cartão está alegando que o valor que concordou em pagar é diferente do valor cobrado.
`DUPLICATE_PROCESSING`	Processamento duplicado/pago por outros meios	Erros de processamento	Uma única transação foi processada duas ou mais vezes.
`INVALID_DATA`	Dados inválidos	Erros de processamento	A autorização foi obtida com dados inválidos ou incorretos.
`PRODUCT_OR_SERVICE_NOT_RECEIVED`	Mercadorias/Serviços não recebidos	Disputas com clientes	O titular do cartão está alegando que a mercadoria ou os serviços que encomendou não foram recebidos.
`CANCELED_RECURRING_TRANSACTION`	Transação recorrente cancelada	Disputas com clientes	Uma transação recorrente foi processada depois de ter sido cancelada.
`PRODUCT_OR_SERVICE_ISSUE`	Mercadorias/Serviços não descritos ou defeituosos	Disputas com clientes	O titular do cartão está alegando que os produtos não eram como descritos.
`COUNTERFEIT_MERCHANDISE`	Mercadoria falsificada	Disputas com clientes	A mercadoria foi identificada como falsificada.
`MISREPRESENTATION`	Deturpação	Disputas com clientes	O banco do titular do cartão recebeu uma notificação do titular do cartão alegando que os termos de venda foram deturpados.
`CREDIT_NOT_PROCESSED`	Crédito não processado	Disputas com clientes	O banco do titular do cartão recebeu uma notificação do titular do cartão alegando que recebeu autorização, crédito ou recibo de transação anulado que não foi processado.
`PRODUCT_OR_SERVICE_CANCELED`	Mercadorias/Serviços cancelados	Disputas com clientes	O banco do titular do cartão recebeu um aviso do titular do cartão informando que ele devolveu uma mercadoria ou cancelou serviços, mas o crédito não apareceu no extrato Visa do titular do cartão.
`ORIGINAL_TRANSACTION_NOT_ACCEPTED`	Transação de crédito original não aceita	Disputas com clientes	O crédito original não foi aceito.
`CASH_TRANSACTION_VALUE`	Não recebimento de dinheiro ou valor de transação de carga	Disputas com clientes	O titular do cartão não recebeu o valor total do saque em dinheiro em um caixa eletrônico.
`CUSTOMER_AGREEMENT`	É necessário comprovar a transação ou o contrato do cliente.	Disputas com clientes	O emissor solicita ao comerciante uma cópia do recibo assinado pelo titular do cartão ou qualquer outra documentação que verifique a concordância do cliente com a compra. Normalmente, para verificar uma transação com cartão presente que o titular do cartão contesta ou não reconhece.