API Reference
GuidesSuporteAPI Reference
These docs are for v2. Click to read the latest docs for v5.

Objeto recebedor

Objeto de resposta da criação de recipient

PropriedadeDescrição
object
String		Nome do tipo do objeto criado/modificado.
Valor retornado: recipient
id
String		Identificador do recebedor.
bank_account
Object		Objeto contendo os dados bancários do recebedor.
transfer_enabled
Boolean		Se o recebedor está habilitado para receber transferências ou não.
last_transfer
Datetime		Data da última transferência (ISODate).
transfer_interval
String		Frequência na qual o recebedor irá ser pago.
Valores possíveis: daily, weekly, monthly.
transfer_day
Integer		Dia no qual o recebedor vai ser pago. Para cada transfer_day, existe uma faixa de pagamento possível.
weekly: 1 a 5, onde 1 é segunda-feira e 5 é sexta-feira
monthly: 1 a 31
daily: 1

OBS: Para monthly=31 e meses com menos de 31 dias, a transferência acontece no primeiro dia útil do mês seguinte.
automatic_anticipation_enabled
Boolean		Se o recebedor está habilitado para receber automaticamente ou não o valor disponível para antecipação.
date_created
Datetime		Data de criação do recebedor (ISODate)
register_information
Object		O campo register_information recebe informações cadastrais do seller.
{
  "object": "recipient",
  "id": "re_cix7pnghi02wm196emgbthh8u",
  "transfer_enabled": true,
  "last_transfer": null,
  "transfer_interval": "weekly",
  "transfer_day": 5,
  "automatic_anticipation_enabled": true,
  "anticipatable_volume_percentage": 85,
  "date_created": "2016-12-27T16:11:58.911Z",
  "date_updated": "2016-12-27T16:11:58.911Z",
  "postback_url": "https://requestb.in/tl0092tl",
  "status": "active",
  "status_reason": null,
  "metadata": null,
  "bank_account": {
    "object": "bank_account",
    "id": 17345188,
    "bank_code": "33",
    "agencia": "00000",
    "agencia_dv": null,
    "conta": "00000",
    "conta_dv": "0",
    "type": "conta_corrente",
    "document_type": "cpf",
    "document_number": "35965816804",
    "legal_name": "Nome much legal",
    "charge_transfer_fees": true,
    "date_created": "2016-12-27T16:08:26.202Z"
  },
  "mcc": "5812",
"register_information": {
  "type": "corporation",
  "document_number": "43633675456",
  "company_name": "Full Name Company",
  "trading_name": "Full Name Company SA",
  "annual_revenue": "1000",
  "corporation_type": "",
  "founding_date": "",
  "cnae": "",
  "email": "[email protected]",
  "site_url":"http://www.site.com",
  "phone_numbers":  [{
    "ddd": "11",
    "number": "11987654321",
    "type": "mobile"
  }],
  "main_address": {
    "street": null,
    "complementary": "SN",
    "street_number": null,
    "neighborhood": null,
    "city": null,
    "state": null,
    "zipcode": null,
    "reference_point": null
  },
  "managing_partners": [{
    "type": "individual",
    "name": "Teste Onboarding",
    "document_number": "50107915014",
    "mother_name": "Eliana das Neves",
    "birthdate": "01/01/0001",
    "email": "[email protected]",
    "monthly_income": "1000",
 		"professional_occupation": "Empresário",
    "self_declared_legal_representative": true,
	  "address": {
      "street": null,
      "complementary": "SN",
      "street_number": null,
      "neighborhood": null,
      "city": null,
      "state": null,
      "zipcode": null,
      "reference_point": null
  },
	  "phone_numbers": [
    {
      "ddd": "27",
      "number": "999992628",
      "type": "primary"
    }
  ]
  }
}

Observações sobre status dos recebedores:

registration: estágio no qual o recebedor já passou pelo pré-credenciamento, e está com o auto credenciamento pendente. Aqui ele pode transacionar, mas não pode sacar o valor.

affiliation: estágio no qual o recebedor já passou pelo auto credenciamento, e está esperando a afiliação por parte do Pagar.me. Ele continua podendo transacionar, mas sem sacar o valor.

active: estágio no qual já passou por todos os estágios do credenciamento, e já pode sacar os valores não bloqueados de sua conta de pagamento.

refused: estágio no qual o recebedor foi recusado no pré-credenciamento ou na afiliação. Neste ponto, avisamos o marketplace, e depois de um período estornamos as vendas feitas.

suspended: estágio no qual o recebedor não se auto credenciou após um período de dias, ou teve pendências no estágio de afiliação. Tem o transacional e saques travados, mas as transações ainda não serão estornadas. Pode voltar para o fluxo de credenciamento/afiliação.

blocked: estágio no qual após ativo, mostrou comportamento suspeito. Tem o transacional e saques travados, mas as transações ainda não serão estornadas. Pode voltar para ativo.

inactive: estágio no qual após ser monitorado, mostrou comportamento suspeito, e comprovamos algo de errado. Quando ele atinge esse estágio, não é possível voltar para ativo.

Campo register_information

O campo register_information recebe informações cadastrais do seller. Abaixo você pode conferir as especificações do campo para pessoa física e jurídica

Campo register_information para pessoa física

Quando o recebedor é uma pessoa física, deve-se usar o valor individual no campo type. 

{
"register_information": {
  "type": "individual",
  "document_number": "12345678910",
  "name": "Someone",
  "site_url": "",
  "email": "[email protected]",
  "mother_name": "Eliana das Neves",
  "birthdate": "01/01/0001",
  "monthly_income": "1000",
  "professional_occupation": "Empresário",
  "address": {
      "street": null,
      "complementary": "SN",
      "street_number": null,
      "neighborhood": null,
      "city": null,
      "state": null,
      "zipcode": null,
      "reference_point": null
  },
  "phone_numbers": [
    {
      "ddd": "27",
      "number": "999992628",
      "type": "primary"
    }
  ]
}
Nome do parâmetroEspecificação do parâmetro
type
obrigatório		Utilizar "individual".
document_number
obrigatório		Número do CPF.
name
obrigatório 		Nome do seller.
site_urlSite do seller.
email
obrigatório		Email do seller
mother_nameNome da mãe
birthday
obrigatório		Data de nascimento
monthly_income
obrigatório		Renda mensal (disponível em Janeiro de 2024)
professional_occupation
obrigatório		Ocupação profissional (disponível em Janeiro de 2024)
address
obrigatório		Endereço completo
phone_numbers
obrigatório		Número de telefone do seller. Deve-se informar o DDD, número e o tipo.

Campo register_information para pessoa jurídica

Quando o recebedor é uma pessoa jurídica, deve-se usar o valor corporation no campo type. 

{
"register_information": {
  "type": "corporation",
  "document_number": "43633675456",
  "company_name": "Full Name Company",
  "trading_name": "Full Name Company SA",
  "annual_revenue": "1000",
  "corporation_type": "",
  "founding_date": "",
  "cnae": "",
  "email": "[email protected]",
  "site_url":"http://www.site.com",
  "phone_numbers":  [{
    "ddd": "11",
    "number": "11987654321",
    "type": "mobile"
  }],
  "main_address": {
    "street": null,
    "complementary": "SN",
    "street_number": null,
    "neighborhood": null,
    "city": null,
    "state": null,
    "zipcode": null,
    "reference_point": null
  },
  "managing_partners": [{
    "type": "individual",
    "name": "Teste Onboarding",
    "document_number": "50107915014",
    "mother_name": "Eliana das Neves",
    "birthdate": "01/01/0001",
    "email": "[email protected]",
    "monthly_income": "1000",
 		"professional_occupation": "Empresário",
    "self_declared_legal_representative": true,
	  "address": {
      "street": null,
      "complementary": "SN",
      "street_number": null,
      "neighborhood": null,
      "city": null,
      "state": null,
      "zipcode": null,
      "reference_point": null
  },
	  "phone_numbers": [
    {
      "ddd": "27",
      "number": "999992628",
      "type": "primary"
    }
  ]
  }
Nome do parâmetroEspecificação do parâmetro
type
obrigatório		Utilizar "corporation"
document_number
obrigatório		Número do CNPJ.
company_name
obrigatório		Nome fantasia do seller.
trading_name
obrigatório		Razão social
annual_revenue
obrigatório		Faturamento anual (disponível em Janeiro de 2024)
corporation_typeTipo da empresa
founding_dateData de fundação
cnaeClassificação Nacional das Atividades Econômicas
email
obrigatório		Email do seller
site_url
obrigatório		Site do seller.
phone_numbers
obrigatório		Número de telefone do seller. Deve-se informar o DDD, número e o tipo.
main_address
obrigatório		Endereço completo
managing_partners
obrigatório		Dados dos sócios listados neste CNPJ/Representante legal, seguir o mesmo padrão do recebedor com type individual.