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 |
|
Advogados e Serviços Legais |
|
Alfaiates / Costureiras |
|
Ambulante |
|
Arquiteto e Engenheiro |
|
Arte e Antiguidades |
|
Artigos Religiosos |
|
Automóveis e Acessórios |
|
Bebês |
|
Borracheiro / Mecânico / Funilaria / Pintura |
|
Cabelereiro / Barbeiro / Manicure |
|
Cama, Mesa e Banho |
|
Celulares e Telefonia |
|
Chaveiro |
|
Comércio de bebidas |
|
Comida, Bebida e Nutricional |
|
Conteúdo Adulto |
|
Corretor de imobiliária |
|
Corretor de seguro |
|
Dentista / Ortodontista |
|
Despachante |
|
Doces e confeitarias |
|
Eletrônicos / Eletrodomésticos |
|
Empreiteiros Autônomos |
|
Entidades Públicas |
|
Esporte |
|
Esteticista / Massagista |
|
Feira Livre |
|
Fisioterapeutas / Fonoaudiólogos / Nutricionista / Psicólogo / Enfermeiros |
|
Fotografia e gravação |
|
Hipermercado / mercado / minimercado |
|
Hospedagem e Turismo |
|
Jardineiro/Florista/Paisagista |
|
Jóias e Relógios |
|
Marceneiros / Serralheiros / Vidraceiros |
|
Médicos em geral |
|
Móveis e Decoração |
|
Padaria |
|
Personal Trainer |
|
Pet Shop |
|
Podólogos / Pedicuros |
|
Reparos diversos |
|
Restaurantes e similares |
|
Roupas e Acessórios |
|
Sapateiro |
|
Serviços de Educação |
|
Serviços de recreação e lazer |
|
Serviços profissionais diversos |
|
Tatuadores |
|
Táxi - Autonomos |
|
Telecomunicações |
|
Vendas à Domicílio |
|
Veterinários |
|
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. |