Cadastro

A API de Cadastro ou API de Contas (accounts) é destinada para Parceiros PagSeguro PagBank que precisam criar contas em nome de terceiros.

A conta criada é uma conta PagBank simples apta a transacionar. Para acessar e movimentar o saldo das vendas nas contas criadas, vendedores, donos da conta, devem encaminhar uma foto do documento via aplicativo PagBank e cadastrar uma senha.

Caso o cliente já tenha uma conta PagBank aberta, será preciso conectar à conta do usuário através da API Connect. Obtendo autorização para realizar ações em nome do usuário PagSeguro.

Para conhecer melhor as funcionalidades que serão disponibilizadas para seus vendedores e compradores:

  • Conta digital sem tarifas e taxas de manutenção;
  • As transferências de dinheiro para outras contas são gratuitas;
  • Por meio da conta digital é possível efetuar pagamentos gratuitamente;
  • Acesso a empréstimos pessoais;
  • Maior rendimento do dinheiro depositado;
  • Saques nos caixas do Banco24horas;
  • Cartão de débito, etc.

O Recurso de Contas, em sua definição, representa a criação de uma conta através de um objeto 'person' e um objeto 'company', contendo informações necessárias exclusivamente para esse fim. De acordo com o tipo de conta escolhida pode ser necessário informar mais ou menos dados.

É possível criar os seguintes tipos de contas:

  • Buyer - conta comprador criada para pessoas físicas
  • Seller - conta vendedor criada para pessoa física ou jurídica, conta apta a vender

Importante: para criar uma conta tipo SELLER é necessário informar uma categoria de negócio.

A categoria de negócio corresponde à classificação do negócio dos usuários. O campo é um ENUM. Os seguintes valores são possíveis:

Business Category

Descrição simplificada

Valor (ENUM)

Açougue

BUTCHERY

Advogados e Serviços Legais

LEGAL_SERVICE

Alfaiates / Costureiras

TAILOR_AND_SEAMSTRESS

Ambulante

ITINERANT_SALE

Arquiteto e Engenheiro

ARCHITECTURAL_AND_ENGINEERING

Arte e Antiguidades

ART_AND_ANTIQUE

Artigos Religiosos

RELIGION_AND_SPIRITUALITY

Automóveis e Acessórios

VEHICLE_AND_PARTS

Bebês

BABY

Borracheiro / Mecânico / Funilaria / Pintura

VEHICLE_SERVICES

Cabelereiro / Barbeiro / Manicure

BEAUTY_AND_BARBER

Cama, Mesa e Banho

BED_AND_BATH

Celulares e Telefonia

TELECOMMUNICATION

Chaveiro

KEY_CHAIN

Comércio de bebidas

PACKAGE_STORE

Comida, Bebida e Nutricional

FOOD_SERVICE

Conteúdo Adulto

ADULT_CONTENT

Corretor de imobiliária

REAL_ESTATE_AGENT

Corretor de seguro

BROKER

Dentista / Ortodontista

DENTISTRY

Despachante

FREIGHT_FORWARDER

Doces e confeitarias

CANDIES_AND_CONFECTIONERIES

Eletrônicos / Eletrodomésticos

HOUSEHOLD_APPLIANCE

Empreiteiros Autônomos

GENERAL_CONTRACTOR

Entidades Públicas

GOVERNMENT

Esporte

SPORT

Esteticista / Massagista

HEALTH_AND_BEAUTY_SERVICE

Feira Livre

NONDURABLE_GOODS

Fisioterapeutas / Fonoaudiólogos / Nutricionista / Psicólogo / Enfermeiros

MEDICAL_SERVICE

Fotografia e gravação

PHOTOGRAPHY_AND_VIDEO

Hipermercado / mercado / minimercado

SUPERMARKET

Hospedagem e Turismo

LODGING

Jardineiro/Florista/Paisagista

FLORIST

Jóias e Relógios

JEWELRY_AND_WATCH

Marceneiros / Serralheiros / Vidraceiros

OTHER_SERVICES

Médicos em geral

DOCTOR

Móveis e Decoração

FURNITURE_AND_DECORATION

Padaria

BAKERY

Personal Trainer

PERSONAL_TRAINER

Pet Shop

PET_SUPPLIES

Podólogos / Pedicuros

PODIATRIST_AND_CHIROPODIST

Reparos diversos

REPAIR_SHOPS

Restaurantes e similares

RESTAURANT

Roupas e Acessórios

CLOTHING_AND_ACCESSORIES

Sapateiro

SHOE_STORE

Serviços de Educação

EDUCATION

Serviços de recreação e lazer

ENTERTAINMENT

Serviços profissionais diversos

PROFESSIONAL_SERVICE

Tatuadores

TATTOOIST

Táxi - Autonomos

TRANSPORTATION_SERVICE

Telecomunicações

TELECOM

Vendas à Domicílio

DOOR_TO_DOOR_SALES

Veterinários

VETERINARY_SERVICE

Restrições para o uso da API de Contas:

Para que uma conta seja criada, determinadas regras de negócio precisam ser seguidas, como:

  • Os dados mínimos obrigatórios devem ser informados dentro do formato esperado;
  • O dono da conta precisa ser maior de 18 anos ou maior de 16 anos emancipado;
  • O conjunto de dados precisa ser validado em uma análise de KYC (know your customer). Isso significa que os documentos do dono da conta precisam estar regularizados perante a Receita Federal;
  • Os dados informados devem ser exatamente iguais ao documento (CPF) e ao cartão do CNPJ (quando se tratar de conta PJ).

AMBIENTES DISPONÍVEIS E SUAS RESPECTIVAS URLs

Ambiente

URL

Sandbox

sandbox.api.pagseguro.com/accounts

Produção

api.pagseguro.com/accounts

📘

TESTANDO UMA CRIAÇÃO DE CONTA

Todas as contas criadas em sandbox serão automaticamente consideradas aprovadas no KYC dada a impossibilidade de simular determinado cenário.

Para conseguir criar uma conta com sucesso, o seguinte domínio de e-mail deve ser utilizado: @sandbox.pagseguro.com.br

❗️

TERMOS DE USO E POLÍTICA DE PRIVACIDADE

É necessário que o dono da conta que está sendo criada aceite os Termos de Uso e a Política de Privacidade do PagSeguro. Para isso, é preciso disponibilizá-los para que o cliente possa fazer o aceite.

As informações de aceite, IP e data, devem ser informadas no momento da requisição de criação da conta.

🚧

CRIAÇÃO DE UMA APLICAÇÃO

Para que você possa realizar ações em nome dos usuários, é preciso criar uma aplicação no 'Connect'. É através desse serviço que serão disponibilizados o 'client ID' e o 'client secret'.

ERROS

Os erros são compostos pelas seguintes informações:

  • Código de erro: código numérico que representa a classe do erro. Exemplo: 40001, 40002, etc;
  • Descrição: classificação do erro. Exemplo: Parâmtero obrigatório, Parâmetro inválido, etc;
  • Parâmetro: campo no payload em que o erro aconteceu. Exemplo: person.name, email,tax_id.company, etc;
  • Mensagem: descrição detalhada do motivo do erro. O objetivo é informar todas as correções necessárias a serem aplicadas no payload para que a uma conta seja criada com sucesso.

Em caso de alguma condição não for atendida, erros retornados pela API deixarão claro qual o que aconteceu. A seguir, temos a seguinte lista de erros:

Código de Erro

Descrição

Significado

40001

Parâmetro obrigatório

Algum dado obrigatório não foi informado

40002

Parâmetro inválido

Algum dado foi informado com formato inválido ou o conjunto de dados não cumpriu todos os requisitos de negócio

42001

Falha na criação de conta

A conta já existe no PagSeguro PagBank. Para ter acesso aos dados dessa conta ou criar pagamentos em nome do dono da conta, é necessário solicitar permissão via Connect.

42002

Falha na criação de conta

O processo de criação foi iniciado por outro canal diferente da API. O usuário precisa acessar o email para finalizar a criação de conta.