Bem-vindo à documentação Pagar.me

Aqui você vai encontrar guias e exemplos para te ajudar
a integrar com a melhor API de Pagamentos do Brasil!

Começar

Você também pode buscar ou navegar pelas categorias

Dados bancários

Os dados bancários que você cadastra nas configurações da Dashboard são informações referentes a sua conta bancária (que pode ser conta corrente, poupança etc), e são utilizados para receber a quantia disponível no seu saldo do Pagar.me.

Já o cadastro da informação bancária de um recebedor é o primeiro passo para realizar a criação desse seller, algo que pode ser feito via API e pela dashboard. Fazer isso é necessário para poder começar a dividir as suas transações dentro do Marketplace.

Criando uma conta bancária

Criar uma conta bancária é bem simples, veja o exemplo:

curl -X POST https://api.pagar.me/1/bank_accounts -H 'content-type: application/json' -d '{
    "agencia": "0932", 
    "agencia_dv": "5", 
    "api_key": "SUA_API_KEY", 
    "bank_code": "341", 
    "conta": "58054", 
    "conta_dv": "1", 
    "document_number": "26268738888", 
    "legal_name": "API BANK ACCOUNT", 
    "type": "conta_corrente"
}'
require 'pagarme'

PagarMe.api_key = "SUA_API_KEY"

bank_account = PagarMe::BankAccount.new({
    :bank_code => '237',
    :agencia => '1935',
    :agencia_dv => '9',
    :conta => '23398',
    :conta_dv => '9',
    :type => 'conta_corrente',
    :legal_name => 'Aardvark Silva',
    :document_number => '26268738888'
})

bank_account.create
<?php
require("vendor/autoload.php");
$pagarme = new PagarMe\Client('SUA_CHAVE_DE_API');

$bankAccount = $pagarme->bankAccounts()->create([
  'bank_code' => '341',
  'agencia' => '0932',
  'agencia_dv' => '5',
  'conta' => '58054',
  'conta_dv' => '1',
  'document_number' => '26268738888',
  'legal_name' => 'API BANK ACCOUNT'
]);
PagarMeService.DefaultApiKey = "SUA_API_KEY";

BankAccount b = new BankAccount();
b.Agencia = "0192";
b.AgenciaDv = "0";
b.Conta = "03245";
b.ContaDv = "0";
b.BankCode = "0341";
b.DocumentNumber = "26268738888";
b.LegalName = "API BANK ACCOUNT";
b.Save();
import me.pagar.model.BankAccount;
import me.pagar.model.PagarMe;
import me.pagar.model.PagarMeException;

PagarMe.init("SUA_API_KEY");

BankAccount account = new BankAccount();
account.setAgencia("0192");
account.setAgenciaDv("0");
account.setConta("03245");
account.setContaDv("0");
account.setBankCode("341");
account.setDocumentNumber("26268738888");
account.setLegalName("API BANK ACCOUNT");
account.save();
import pagarme from 'pagarme'

pagarme.client.connect({ api_key: 'SUA_API_KEY' })
  .then(client => client.bankAccounts.create({
    bank_code: '237',
    agencia: '1935',
    agencia_dv: '9',
    conta: '23398',
    conta_dv: '9',
    legal_name: 'API BANK ACCOUNT',
    document_number: '26268738888'
  }))
  .then(bankAccount => console.log(bankAccount))
import pagarme

pagarme.authentication_key('SUA_API_KEY')

params = {
    'agencia': '0932',
    'agencia_dv': '5',
    'bank_code': '341',
    'conta': '58054',
    'conta_dv': '1',
    'document_number': '26268738888',
    'legal_name': 'HOUSE TARGARYEN'
}

bank_account = pagarme.bank_account.create(params)

print(bank_account)

Parâmetros de uma conta bancária

Veja um pouco mais sobre cada parâmetro:

Parâmetro

Descrição

Restrições

bank_code
obrigatório

Código do banco

3 números

agencia
obrigatório

Agência

5 números

agencia_dv

Dígito verificador da agência

1 dígito - não obrigatório

conta
obrigatório

Número da conta

13 números

conta_dv
obrigatório

Dígito verificador da conta

2 alfanuméricos

document_number
obrigatório

CPF ou CNPJ da conta

Com ou sem pontuações

legal_name
obrigatório

Nome completo ou razão social

Máximo de 30 caracteres, somente letras

type
Default: conta_corrente

Tipo da conta

conta_corrente, conta_poupanca, conta_corrente_conjunta, conta_poupanca_conjunta

Observações

🚧

Vale ressaltar

Caso a agencia não tenha dígito verificador, não é preciso enviar o agencia_dv.

Updated 6 months ago


Próximo

Excelente! Agora que você já tem os dados bancários do seu recebedor, vamos criar um recipient, objeto que tem um ID e que é usado na sua regra de split. Vamos lá!

Recebedores

Dados bancários


Suggested Edits are limited on API Reference Pages

You can only suggest edits to Markdown body content, but not to the API spec.