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âmetroDescriçãoRestrições
bank_code
obrigatório
Código do banco3 números
agencia
obrigatório
Agência5 números
agencia_dvDígito verificador da agência1 dígito - não obrigatório
conta
obrigatório
Número da conta13 números
conta_dv
obrigatório
Dígito verificador da conta2 alfanuméricos
document_number
obrigatório
CPF ou CNPJ da contaCom ou sem pontuações
legal_name
obrigatório
Nome completo ou razão socialMáximo de 30 caracteres, somente letras
type
Default: conta_corrente
Tipo da contaconta_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.


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á!