Um método de pagamento é a conta bancária que você (ou seu usuário) registra para que os fundos possam ser retirados dela. Para retirar fundos do método de pagamento, você precisará criar uma solicitação de pagamento.

Fluxo do Método de Pagamento

Copiar

• Copiar para LLM

  Copiar página como Markdown para LLMs
• Ver como Markdown

  Abrir esta página como Markdown
• Abrir no ChatGPT

  Obter insights do ChatGPT
• Abrir no Claude

  Obter insights do Claude
• Conectar ao Cursor

  Instalar servidor MCP no Cursor
• Conectar ao VS Code

  Instalar servidor MCP no VS Code

Quando você cria um método de pagamento, ele passará pelo seguinte fluxo para ser:

• active: A instituição financeira confirma os detalhes da conta bancária e você pode recuperar fundos dela.
• error: A instituição financeira não pôde confirmar a conta bancária e você não pode recuperar fundos dela.

Criar um método de pagamento

Você pode criar um método de pagamento usando:

• Dashboard
• API
• Importações em Lote

Via o painel

Para criar um método de pagamento usando nosso painel:

1. No seu painel de Débito Direto:

   1. Vá para Métodos de Pagamento.

   2. Clique em Criar.

      

2. No pop-up Criar Método de Pagamento;

   1. Selecione o Cliente ao qual este método de pagamento se refere.
   2. Selecione o Banco onde a conta do cliente está localizada.
   3. Selecione o tipo de Conta: Poupança para uma conta CLABE, ou Cartão de Débito para um número de cartão de débito.
   4. Forneça o identificador da conta: se você selecionou Poupança, insira o CLABE do cliente; se você selecionou Cartão de Débito, insira o número do cartão de débito.
   5. Forneça sua Referência interna para este método de pagamento.
   6. Clique em Criar.
   

Via a API

Para criar um método de pagamento usando nossa API, você só precisa fazer uma solicitação POST para Criar um método de pagamento com o seguinte payload:

{
  "customerId": "0d1a377b-b4c5-4a94-9e2e-83e59d1f6a9c",
  "accountType": "savings",
  "accountNumber": "445566790",
  "bank": "mx_bancoppel",
  "reference": "SAVINGS_445566790"
}

Status dos Métodos de Pagamento

No diagrama abaixo, fornecemos os status pelos quais um método de pagamento pode passar. Se você implementou webhooks, receberá uma notificação para os status indicados em roxo.

States

initial

Estado inicial quando o método de pagamento é criado.

pending_agreement_acceptance

O método de pagamento está pendente de confirmação pelo cliente. Isso pode ser feito enviando um acordo gerado pelo nosso recurso de API de Agreements.

pending_activation

O método de pagamento está programado para ser enviado à instituição financeira para ser confirmado.

pending_activation_response

A instituição financeira está avaliando o método de pagamento.

active

O método de pagamento está ativo e os fundos podem ser retirados.

Nota: O status pode mudar para inactive se o proprietário cancelar ou remover o método de pagamento dentro de sua instituição financeira.

error

A instituição financeira não conseguiu confirmar o registro da conta bancária (geralmente devido ao proprietário fornecer informações incorretas da conta bancária ou um erro na instituição financeira). O método de pagamento não pode ser usado.

inactive

O cliente cancelou sua conta bancária ou removeu seu acordo para o método de pagamento dentro de sua instituição financeira. O método de pagamento não pode ser usado.