Códigos de falha

Quando uma cobrança não é aprovada, a charge chega ao estado failed e o motivo vem resolvido em um único grupo: payment_error. A Chargefy lê todos os sinais do processamento — código bruto da rede, resposta do emissor, validações locais — e publica uma única leitura final, com categoria, código estável, mensagem e orientação. A evidência bruta da rede, quando existe, vem no mesmo grupo com o prefixo network_*. O mesmo shape aparece em payment_intent.last_payment_error com a última tentativa recusada do intent.

O único objeto que você precisa ler

payment_error é null em cobranças aprovadas. Quando preenchido:

Campo	Tipo	Quem resolve	Descrição
`payment_error.category`	`string \| null`	Chargefy	Categoria geral da recusa — agrupa os códigos em quatro grupos acionáveis (veja abaixo).
`payment_error.code`	`string \| null`	Chargefy	Código estável e legível do motivo (`insufficient_funds`, `expired_card`, …).
`payment_error.message`	`string \| null`	Chargefy	Mensagem em inglês, voltada a logs e desenvolvedores.
`payment_error.advice_code`	`string \| null`	Chargefy	Orientação desta ocorrência: `confirm_card_data`, `do_not_try_again`, `try_again_later`.
`payment_error.network_advice_code`	`string \| null`	Rede (dado bruto)	Advice bruto da bandeira (ex.: merchant advice code), quando a rede enviou um.
`payment_error.network_decline_code`	`string \| null`	Rede (dado bruto)	Código bruto de recusa da rede, quando ela respondeu.

A divisão é deliberada: os quatro campos resolvidos pela Chargefy são o contrato estável — ramifique sua integração por eles. Os dois network_* são evidência bruta para diagnóstico e suporte: não são universais, variam por bandeira, só fazem sentido analisados junto de payment_method_details.card.brand e podem ser null quando a rede não devolve um sinal confiável.

payment_error.message é texto para dev/log em inglês. A mensagem amigável que o comprador vê no checkout hospedado é localizada em português e derivada do mesmo payment_error.code — veja a coluna “Mensagem segura” abaixo. Não exiba message nem códigos crus ao comprador.

Recusa definitiva vs resultado não confirmado

Cada charge representa uma tentativa de cobrar; o payment_intent representa o pagamento que você quer concluir e pode receber outra tentativa quando a anterior termina recusada.

O que aconteceu	Estado observável	O que fazer
A tentativa foi aprovada	`charge.status: "succeeded"` e `payment_intent.status: "succeeded"`	Conclua o pedido.
A tentativa terminou recusada	`charge.status: "failed"` com `payment_error`; o intent volta para `requires_payment_method`	Siga `payment_error.advice_code` e `payment_error.code`. Confirme o mesmo intent de novo.
O resultado financeiro ainda não pôde ser confirmado	A API responde `502` com `error.code: "payment_result_unconfirmed"`; o recurso permanece em processamento	Não repita o write. Consulte o recurso pelo ID e aguarde o webhook.
A resposta de falha não tem classificação específica	A falha é exposta como `processing_error` e registrada para investigação	Não presuma sucesso nem faça retry cego; consulte o recurso e use o identificador da request no suporte.

Um timeout não prova que a cobrança falhou. Quando receber payment_result_unconfirmed, repetir a criação ou confirmação pode produzir uma segunda cobrança. Consulte o mesmo recurso até obter o desfecho.

Uma charge recusada é terminal, mas o payment_intent não precisa ser. Em requires_payment_method, confirme novamente o mesmo intent com os dados corrigidos, outro cartão ou outro método. Não crie outro intent só porque uma tentativa falhou.

Testar códigos no sandbox

Todos os payment_error.code desta página têm um cartão de sandbox correspondente. Use a tabela completa em Sandbox para escolher o cartão e ver o resultado esperado (payment_error.category, payment_error.code e payment_error.message).

Categorias (`category`)

category agrupa os motivos em quatro baldes, úteis para decidir o tratamento sem precisar ramificar por cada code:

`category`	Significado	Ação recomendada	Retentativa
`issuer_declined`	O emissor ou a rede recusou a tentativa.	Peça outro cartão ou oriente contato com o banco.	Depende do `code`.
`invalid`	Os dados ou o método precisam de correção.	Corrija os dados antes de reenviar.	Só depois da correção.
`blocked`	Existe restrição ou suspeita de fraude.	Interrompa a repetição e oriente contato com o banco.	Em geral, não.
`processing_error`	Houve falha técnica, de configuração ou de comunicação.	Leia o `code` e confirme o estado antes de qualquer repetição.	Depende do `code` e de `payment_error.advice_code`.

Códigos Chargefy (`code`)

Cada motivo de falha vira um payment_error.code estável e granular. Abaixo, os códigos estão agrupados por category. Significado explica o que aconteceu; Mensagem segura é o texto que o checkout hospedado pode exibir ao comprador; Ação recomendada orienta o próximo passo da integração.

`issuer_declined` — o banco emissor recusou

`code`	Significado	Mensagem segura	Ação recomendada
`insufficient_funds`	Saldo ou margem insuficiente para concluir a compra.	”Tente usar outro cartão ou verifique o seu saldo/limite disponível.”	Tente mais tarde ou peça outro cartão.
`do_not_honor`	Recusa do emissor sem motivo específico (a mais comum).	”Transação não autorizada pelo banco. Tente outro cartão ou entre em contato com o emissor.”	Peça outro cartão ou contato com o banco.
`generic_decline`	Recusa genérica, em geral por divergência nos dados.	”Confirme os dados do cartão ou tente usar outro cartão.”	Confira os dados e peça outro cartão se persistir.
`call_issuer`	O emissor pede que o portador entre em contato.	”Entre em contato com o banco emissor do cartão.”	Oriente contato com o banco antes de repetir.
`card_velocity_exceeded`	Limite de valor ou de quantidade de transações excedido.	”Limite de uso do cartão atingido. Entre em contato com o banco ou tente outro cartão.”	Aguarde o limite liberar ou peça outro cartão.
`invalid_amount`	Valor não permitido para o cartão.	”O valor da compra não é permitido para este cartão. Verifique com o banco.”	Revise o valor ou peça outro cartão.
`invalid_account`	Conta vinculada ao cartão inexistente ou inválida.	”A conta vinculada ao cartão é inválida. Verifique com o banco emissor.”	Peça outro cartão ou contato com o banco.
`transaction_not_permitted`	Operação não habilitada para o portador (ex.: compra pela internet).	”Verifique com o banco se o seu cartão está habilitado para compras pela internet.”	Peça habilitação ou outro cartão.
`service_not_allowed`	Tipo de transação não permitido para o cartão.	”Este tipo de transação não é permitido para o cartão. Verifique com o banco.”	Peça outro cartão ou contato com o banco.
`card_not_supported`	Cartão não aceita este tipo de compra.	”O cartão não aceita este tipo de compra. Tente outro cartão.”	Peça outro cartão.
`currency_not_supported`	Cartão não aceita a moeda da transação.	”O cartão não aceita a moeda da transação. Tente outro cartão.”	Peça outro cartão.
`card_not_activated`	Cartão ainda não desbloqueado pelo cliente.	”Desbloqueie o cartão no app do seu banco e tente novamente.”	Peça desbloqueio antes de repetir.
`authentication_required`	Transação exige autenticação do portador.	”Sua transação precisa de autenticação. Tente novamente e confirme com o banco.”	Refaça com autenticação do portador.
`reenter_transaction`	O emissor não processou a transação; vale repetir.	”Não foi possível processar. Tente novamente.”	Aguarde um instante e tente novamente.
`approve_with_id`	Não foi possível autorizar o pagamento.	”Não foi possível autorizar o pagamento. Tente novamente ou use outro cartão.”	Tente novamente ou peça outro cartão.
`not_permitted`	Operação não suportada pelo cartão.	”A operação não é suportada pelo cartão. Tente outro cartão.”	Peça outro cartão.
`testmode_decline`	Recusa disparada por um cartão de teste.	”Não foi possível concluir o pagamento. Tente novamente.”	Use outro cenário de sandbox.
`payment_failed`	Recusa sem um motivo detalhado disponível (fallback).	”Não foi possível concluir o pagamento. Tente novamente.”	Peça outro cartão; use os demais campos no suporte.

`invalid` — dados do cartão incorretos

`code`	Significado	Mensagem segura	Ação recomendada
`expired_card`	Cartão vencido ou data de validade já passou.	”Verifique a data de validade ou utilize um cartão válido.”	Atualize a validade ou peça outro cartão.
`incorrect_cvc`	Código de segurança (CVV) não confere.	”Confirme o código de segurança (CVV) do cartão.”	Corrija o CVC antes de reenviar.
`incorrect_number`	Número do cartão incorreto.	”Confirme o número do cartão e tente novamente.”	Corrija o número antes de reenviar.
`invalid_number`	Número do cartão inválido ou emissor inexistente.	”O número do cartão é inválido. Confira os dados e tente novamente.”	Corrija o número ou peça outro cartão.
`incorrect_pin`	Senha do cartão incorreta.	”A senha do cartão está incorreta.”	Corrija a senha antes de repetir.
`invalid_pin`	Senha do cartão inválida.	”A senha do cartão é inválida.”	Peça outro cartão ou contato com o banco.
`pin_try_exceeded`	Tentativas de senha excedidas.	”Número de tentativas de senha excedido. Use outro cartão.”	Não insista; peça outro cartão.
`invalid_transaction`	Transação inválida.	”Não foi possível processar a transação. Confira os dados e tente novamente.”	Revise os dados antes de reenviar.
`no_payment_method`	Nenhuma forma de pagamento disponível para cobrar (ex.: assinatura sem cartão).	”Nenhuma forma de pagamento disponível para a cobrança.”	Associe um método de pagamento e tente novamente.
`card_unusable`	Cartão salvo não pôde ser usado.	”O cartão salvo não pôde ser usado. Use outro cartão.”	Atualize ou substitua o cartão salvo.
`payment_method_mismatch`	Forma de pagamento não pertence ao cliente cobrado.	”Use uma forma de pagamento deste cliente.”	Use um método associado ao mesmo cliente.
`invalid_cvc`	Formato do código de segurança inválido antes da autorização.	”Confira o código de segurança do cartão e tente novamente.”	Corrija `cvc` antes de reenviar.
`invalid_expiry_month`	Formato do mês de validade inválido.	”Confira o mês de validade do cartão e tente novamente.”	Corrija `exp_month`.
`invalid_expiry_year`	Formato do ano de validade inválido.	”Confira o ano de validade do cartão e tente novamente.”	Corrija `exp_year`.
`invalid_name`	Nome do titular inválido.	”Confira o nome impresso no cartão e tente novamente.”	Corrija `name`.
`invalid_request`	A solicitação contém um campo inválido.	”Confira os dados informados e tente novamente.”	Corrija o campo indicado em `error.param`.
`invalid_token`	Token do cartão inválido, expirado ou já consumido.	”Informe os dados do cartão novamente para continuar.”	Gere um token novo.
`new_account_information_available`	O emissor pede dados atualizados do cartão ou da conta.	”Atualize os dados do cartão ou use outro cartão.”	Colete dados novos antes de repetir.

`blocked` — restrição ou suspeita de fraude

`code`	Significado	Mensagem segura	Ação recomendada
`lost_card`	Cartão informado como perdido.	”Transação recusada. Entre em contato com a central do seu cartão.”	Não repita; peça outro cartão.
`stolen_card`	Cartão informado como roubado.	”Transação recusada. Entre em contato com a central do seu cartão.”	Não repita; peça outro cartão.
`pickup_card`	Cartão retido por orientação do emissor.	”Transação recusada. Entre em contato com a central do seu cartão.”	Não repita; oriente contato com o banco.
`restricted_card`	Cartão em lista de restrição do emissor.	”Transação recusada. Entre em contato com a central do seu cartão.”	Peça outro cartão ou contato com o banco.
`fraudulent`	Transação marcada como suspeita de fraude.	”Transação recusada. Entre em contato com a central do seu cartão.”	Não repita; peça outro cartão.
`security_violation`	Recusa por violação de segurança.	”Transação recusada por segurança. Entre em contato com a central do seu cartão.”	Oriente contato com o banco antes de repetir.
`stop_payment_order`	Ordem de sustação para o cartão.	”Há uma ordem de sustação para este cartão. Entre em contato com o banco.”	Não insista; oriente contato com o banco.
`revocation_of_authorization`	Autorização do cartão revogada.	”A autorização deste cartão foi revogada. Entre em contato com o banco.”	Não repita; peça outro cartão.
`revocation_of_all_authorizations`	Todas as autorizações do cartão revogadas.	”As autorizações deste cartão foram revogadas. Entre em contato com o banco.”	Não repita; peça outro cartão.
`transaction_not_allowed`	Transação não permitida.	”Transação não permitida. Entre em contato com a central do seu cartão.”	Não repita; oriente contato com o banco.
`single_use_card`	Cartão de uso único não pode ser reutilizado.	”Este cartão não pode ser usado novamente. Use outro cartão.”	Não repita; peça outro método.

`processing_error` — falha técnica ou de conectividade

`code`	Significado	Mensagem segura	Ação recomendada
`issuer_unavailable`	Banco emissor fora do ar ou timeout na comunicação.	”Sistema do banco temporariamente indisponível. Tente novamente em instantes.”	Aguarde e tente novamente.
`routing_error`	Não foi possível rotear a transação ao emissor.	”Não foi possível concluir o pagamento. Tente novamente em instantes.”	Aguarde e tente novamente.
`duplicate_transaction`	Transação duplicada detectada.	”Esta transação parece duplicada. Verifique se o pagamento já foi feito.”	Verifique a cobrança anterior antes de repetir.
`try_again_later`	Falha temporária no processamento.	”Não foi possível processar o pagamento. Tente novamente em instantes.”	Aguarde e tente novamente.
`connection_error`	Falha de conexão com o processador.	”Não foi possível conectar ao processador de pagamento. Tente novamente.”	Confirme o estado da tentativa antes de repetir.
`customer_unavailable`	Cliente não pôde ser identificado para a cobrança.	”Não foi possível identificar o cliente para esta cobrança.”	Confirme o cliente e tente novamente.
`processing_error`	Falha de comunicação na rede ou erro interno.	”Ocorreu uma falha no processamento. Tente novamente.”	Confirme o estado, aguarde e tente novamente.
`authentication_not_available`	A autenticação exigida não está disponível para a tentativa.	”Não foi possível confirmar este cartão. Use outra forma de pagamento.”	Não repita igual; use outro método e acione o suporte.
`merchant_not_approved`	A conta de recebimento não está apta para cobrar.	”Não foi possível concluir o pagamento agora. Use outra forma de pagamento.”	O comprador não resolve; a organização deve acionar o suporte.
`authorization_expired`	A autorização venceu antes da captura ou conclusão.	”A autorização deste pagamento expirou.”	Crie uma nova tentativa em vez de reutilizar a anterior.
`capture_method_not_supported`	A forma de captura solicitada não é aceita.	”Esta forma de captura não está disponível para o pagamento.”	Ajuste a forma de captura antes de repetir.
`charge_already_captured`	A cobrança já foi capturada.	”Este pagamento já foi capturado.”	Consulte a cobrança existente; não capture novamente.
`charge_already_refunded`	A cobrança já foi estornada.	”Este pagamento já foi estornado.”	Consulte os estornos existentes; não crie outro.
`partial_refund_not_supported`	A operação aceita somente estorno total.	”Este pagamento não aceita estorno parcial.”	Estorne o saldo total reembolsável.
`payment_intent_unexpected_state`	O pagamento está em um estado incompatível com a operação.	”O pagamento não está em um estado que permita esta operação.”	Consulte o estado atual antes de decidir o próximo passo.
`refund_period_expired`	O prazo permitido para o estorno terminou.	”O prazo para estornar este pagamento terminou.”	Não repita; trate a devolução por outro fluxo operacional.
`refund_state_mismatch`	O estado local e o financeiro não puderam ser conciliados.	”O resultado do estorno ainda não pôde ser confirmado.”	Não repita cegamente; consulte o recurso ou acione o suporte.

processing_error não autoriza retry cego. Quando a API responder payment_result_unconfirmed, a tentativa pode existir: consulte o Payment Intent/Checkout Session e aguarde o webhook. Repetir o write pode cobrar duas vezes.

Se um sinal de falha ainda não tiver classificação específica, a Chargefy não o trata como sucesso nem o deixa sem resposta. A integração recebe o fallback processing_error, a ocorrência é registrada para investigação e o estado do recurso deve ser consultado antes de qualquer nova tentativa.

Como decidir a retentativa

payment_error.advice_code descreve a orientação disponível para aquela ocorrência. Ele complementa payment_error.code; não substitui o estado atual do recurso.

`advice_code`	O que significa	Próximo passo
`confirm_card_data`	Os dados precisam ser conferidos.	Corrija os dados antes de confirmar novamente.
`try_again_later`	Uma nova tentativa pode fazer sentido.	Aguarde e reconfirme apenas quando o intent permitir uma nova tentativa.
`do_not_try_again`	Repetir a mesma tentativa não é recomendado.	Use outro método ou siga a orientação de `payment_error.code`.
`null`	Não existe orientação específica comprovada.	Decida pelo `payment_error.code` e pelo estado atual.

Uma nova tentativa após correção é diferente de repetir automaticamente a mesma request. Use uma chave de idempotência para retries seguros de transporte e nunca transforme payment_result_unconfirmed em um novo write. Em cobranças recorrentes, do_not_try_again interrompe a repetição automática do mesmo método sem encerrar a cobrança em aberto. O comprador ainda pode atualizar o cartão ou pagar por outro método; essa ação cria uma nova tentativa dentro do mesmo pagamento.

Quando os campos ficam `null`

Campo	Fica `null` quando	O que isso significa
`payment_error`	A cobrança não terminou recusada.	Não há falha a tratar; leia `status`.
`advice_code`	Não existe uma orientação específica comprovada.	Decida pelo `code` e pelo estado do recurso.
`network_advice_code`	Nenhuma orientação bruta foi recebida da rede.	Não há instrução adicional da bandeira.
`network_decline_code`	A rede não devolveu um código bruto confiável.	Falta de evidência; não é um código desconhecido inventado.

Onde o motivo aparece

Resposta da API — GET /v1/charges/{id} traz payment_error; GET /v1/payment-intents/{id} traz last_payment_error da última tentativa, no mesmo shape.
Webhooks — charge.failed carrega payment_error; o payment.intent.updated da recusa carrega last_payment_error no objeto completo em data.object.
Checkout hospedado — o comprador vê a mensagem localizada correspondente ao code, sem nenhum código técnico.

Exemplo: `charge.failed`

{
  "id": "evt_4RtWpKm9YhBqTzXe",
  "object": "event",
  "created_at": "2026-05-19T18:35:00Z",
  "data": {
    "object": {
      "id": "ch_7VgNwPqR2sKdYuMa",
      "object": "charge",
      "amount": 9990,
      "amount_captured": 0,
      "amount_refunded": 0,
      "billing_details": {
        "billing_address": {},
        "document": "12345678901",
        "document_type": "cpf",
        "email": "nome@email.com",
        "name": "Cliente Exemplo"
      },
      "captured": false,
      "created_at": "2026-05-19T18:34:58Z",
      "currency": "brl",
      "customer": "cus_9JhTrLm3WnQpXbZe",
      "description": "Assinatura do Plano Pro",
      "disputed": false,
      "invoice": "inv_5KtYwNv8RqPmHdSa",
      "livemode": true,
      "metadata": {},
      "paid": false,
      "payment_error": {
        "advice_code": "try_again_later",
        "category": "issuer_declined",
        "code": "insufficient_funds",
        "message": "The card has insufficient funds to complete the purchase.",
        "network_advice_code": null,
        "network_decline_code": "51"
      },
      "payment_intent": "pi_6WbXzQn4TrKgYvMe",
      "payment_method": "pm_8RnVtLp2QwKsXcYa",
      "payment_method_details": {
        "card": {
          "amount_authorized": null,
          "authorization_code": null,
          "brand": "visa",
          "checks": {
            "address_line1_check": "unchecked",
            "address_postal_code_check": "unchecked",
            "cvc_check": "pass"
          },
          "country": null,
          "exp_month": 12,
          "exp_year": 2030,
          "funding": null,
          "installments": 1,
          "last4": "4242",
          "network": null
        },
        "type": "credit_card"
      },
      "receipt_url": null,
      "refunded": false,
      "refunds": {
        "object": "list",
        "data": [],
        "has_more": false,
        "url": "/v1/refunds?charge=ch_7VgNwPqR2sKdYuMa"
      },
      "status": "failed",
      "updated_at": "2026-05-19T18:35:00Z"
    }
  },
  "livemode": true,
  "organization": "org_3QpWkTn7VrMgZbXe",
  "request": {
    "id": null
  },
  "type": "charge.failed"
}

O valor 51 em network_decline_code é um sinal bruto: só deve ser analisado junto de payment_method_details.card.brand. O código Chargefy em payment_error.code é o dado estável para a sua integração.

Como tratar a recusa

Ramifique pela payment_error.category para o tratamento geral e pelo payment_error.code quando precisar de uma mensagem específica. Use payment_error.advice_code para decidir a retentativa. Recusas blocked (como restricted_card, lost_card ou stolen_card) exigem que o cliente use outro método ou acione o banco.

Reaja ao webhook charge.failed em vez de fazer polling.
Use o metadata da charge/intent para correlacionar a recusa com o pedido no seu sistema.
Para cobranças recorrentes, uma recusa de ciclo move a assinatura para past_due ou unpaid — acompanhe o evento subscription.updated.

Próximos passos

Cobranças

O objeto charge e o ciclo de uma tentativa de cobrança.

Payment Intents

O processo que materializa a charge e expõe last_payment_error.

Evento charge.failed

Payload completo do webhook de cobrança recusada.

Objeto charge

Schema público completo, com o objeto payment_error.

{
  "id": "evt_4RtWpKm9YhBqTzXe",
  "object": "event",
  "created_at": "2026-05-19T18:35:00Z",
  "data": {
    "object": {
      "id": "ch_7VgNwPqR2sKdYuMa",
      "object": "charge",
      "amount": 9990,
      "amount_captured": 0,
      "amount_refunded": 0,
      "billing_details": {
        "billing_address": {},
        "document": "12345678901",
        "document_type": "cpf",
        "email": "nome@email.com",
        "name": "Cliente Exemplo"
      },
      "captured": false,
      "created_at": "2026-05-19T18:34:58Z",
      "currency": "brl",
      "customer": "cus_9JhTrLm3WnQpXbZe",
      "description": "Assinatura do Plano Pro",
      "disputed": false,
      "invoice": "inv_5KtYwNv8RqPmHdSa",
      "livemode": true,
      "metadata": {},
      "paid": false,
      "payment_error": {
        "advice_code": "try_again_later",
        "category": "issuer_declined",
        "code": "insufficient_funds",
        "message": "The card has insufficient funds to complete the purchase.",
        "network_advice_code": null,
        "network_decline_code": "51"
      },
      "payment_intent": "pi_6WbXzQn4TrKgYvMe",
      "payment_method": "pm_8RnVtLp2QwKsXcYa",
      "payment_method_details": {
        "card": {
          "amount_authorized": null,
          "authorization_code": null,
          "brand": "visa",
          "checks": {
            "address_line1_check": "unchecked",
            "address_postal_code_check": "unchecked",
            "cvc_check": "pass"
          },
          "country": null,
          "exp_month": 12,
          "exp_year": 2030,
          "funding": null,
          "installments": 1,
          "last4": "4242",
          "network": null
        },
        "type": "credit_card"
      },
      "receipt_url": null,
      "refunded": false,
      "refunds": {
        "object": "list",
        "data": [],
        "has_more": false,
        "url": "/v1/refunds?charge=ch_7VgNwPqR2sKdYuMa"
      },
      "status": "failed",
      "updated_at": "2026-05-19T18:35:00Z"
    }
  },
  "livemode": true,
  "organization": "org_3QpWkTn7VrMgZbXe",
  "request": {
    "id": null
  },
  "type": "charge.failed"
}

Fundamentos da API

Objetos de sistema

Webhooks e eventos

SDKs

MCP

Códigos de falha

O único objeto que você precisa ler

Recusa definitiva vs resultado não confirmado

Testar códigos no sandbox

Categorias (`category`)

Códigos Chargefy (`code`)

`issuer_declined` — o banco emissor recusou

`invalid` — dados do cartão incorretos

`blocked` — restrição ou suspeita de fraude

`processing_error` — falha técnica ou de conectividade

Como decidir a retentativa

Quando os campos ficam `null`

Onde o motivo aparece

Exemplo: `charge.failed`

Como tratar a recusa

Próximos passos

Cobranças

Payment Intents

Evento charge.failed

Objeto charge

​O único objeto que você precisa ler

​Recusa definitiva vs resultado não confirmado

​Testar códigos no sandbox

​Categorias (category)

​Códigos Chargefy (code)

​issuer_declined — o banco emissor recusou

​invalid — dados do cartão incorretos

​blocked — restrição ou suspeita de fraude

​processing_error — falha técnica ou de conectividade

​Como decidir a retentativa

​Quando os campos ficam null

​Onde o motivo aparece

​Exemplo: charge.failed

​Como tratar a recusa

​Próximos passos

Cobranças

Payment Intents

Evento charge.failed

Objeto charge

O único objeto que você precisa ler

Recusa definitiva vs resultado não confirmado

Testar códigos no sandbox

Categorias (`category`)

Códigos Chargefy (`code`)

`issuer_declined` — o banco emissor recusou

`invalid` — dados do cartão incorretos

`blocked` — restrição ou suspeita de fraude

`processing_error` — falha técnica ou de conectividade

Como decidir a retentativa

Quando os campos ficam `null`

Onde o motivo aparece

Exemplo: `charge.failed`

Como tratar a recusa

Próximos passos