Cadastro

A API de Cadastro ou API de Contas (accounts) é destinada para Parceiros PagSeguro PagBank que precisam criar contas em nome de terceiros. Através dela o cliente pode criar uma conta PagSeguro ou se conectar a uma conta já existente dentro da plataforma do próprio parceiro.

A conta criada é uma conta PagBank simples apta a transacionar. Para acessar e movimentar o saldo das vendas nas contas criadas, o dono da nova conta deve passar pelo processo de avanço de conta, seguindo o fluxo solicitado via app PagBank. O processo inclui encaminhar uma foto do documento, tirar uma self 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

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

📘

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.

Termos de uso
Política de Privacidade

🚧

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: