Recebedores

Um recipient é um recebedor — isto é, um vendedor ou empresa que expõe os seus produtos dentro do seu Marketplace. Dentro do ambiente Pagar.me é atribuído um saldo a esse recebedor de acordo com as transações que tenham sido criadas para o mesmo. O primeiro passo para isso dividir transações entre diferentes recebedores é criar o objeto recipient pela API.

É através de um recipient que você especifica as suas regras de split, para que os valores a receber sejam automaticamente atribuídos a cada um dos sellers envolvidos na transação.

Parâmetros de um recebedor

Veja a tabela a seguir para entender cada parâmetro:

Campos

Definição

name

Nome do recebedor

email

E-mail do recebedor

description

Descrição do recebedor.

document

CPF ou CNPJ do recebedor.

type

Tipo de recebedor. Valores possíveis: individual (pessoa física) ou company (pessoa jurídica)

default_bank_account

Dados da conta bancária do recebedor

transfer-settings

Essa propriedade define se o recebedor pode receber seus pagamentos automaticamente, no dia e no intervalo que forem definidos.

automatic_anticipation_settings

Essa propriedade define se o recebedor pode antecipar seus recebíveis automaticamente, no dia e no intervalo que forem definidos.

metadata

Objeto com dados adicionais do recebedor.

Saques automáticos

Ao ativar o saque automático para um recebedor, o Pagar.me efetua transferências de acordo com a periodicidade configurada (diariamente, semanalmente ou mensalmente) e conforme o valor total disponível na conta do recebedor para a conta bancária vinculada. Vale reforçar que os saques automáticos só são criados quando o saldo global do recebedor (soma do saldo a receber e do saldo disponível) for positivo e quando o saldo disponível do recebedor for menor ou igual ao saldo disponível da company (soma do saldo de todos os recebedores).

Os saques são criados após a liquidação dos pagamentos que estão previstos para o dia. A exceção são as liquidações de PIX que podem ocorrer durante o dia conforme o pagamento dos clientes finais e, caso tais valores estiverem disponíveis após um saque automático, serão transferidos no saque automático subsequente ou mediante a solicitação de um saque manual.

Ainda, em caso de falha de um saque automático que esteja configurado como diário ou semanal, uma nova tentativa é realizada no próximo dia previsto pela configuração (dia seguinte ou na semana seguinte, respectivamente). Se a falha ocorrer em um recebedor que esteja configurado com saque mensal, ocorrerão novas tentativas nos dias úteis seguintes até que se obtenha sucesso ou até o último dia útil do mês, o que ocorrer primeiro. Caso a falha persista, ao virar o mês uma nova tentativa somente será realizada no dia configurado no campo transfer_day.

❗️

Informação importante

Os saques automáticos só são criados em dias úteis.

👍

Saque diário

Quando o parâmetro transfer_interval, dentro das configurações de transferência, for definido como daily, o recebedor terá saque diário, portanto não é necessário informar o parâmetro transfer_day, que define qual dia será realizado o saque.

Observações

❗️

Recebedores inativos

Todos os recebedores que foram criados a mais de 60 dias, não possuem valores a receber e não transacionaram ou realizaram transferências neste período, terão a transferência automática desabilitada. Mesmo que esse recebedor volte a transacionar eventualmente, a transferência automática precisa ser reabilitada manualmente.

❗️

Alterando um recebedor

Ao atrelar uma conta bancária a um recebedor, somente será possível trocar a conta se a nova tiver o mesmo número de documento (seja ele CPF ou CNPJ). Caso contrário, essa ação não é possível.

Para aprender como atualizar um recebedor, leia mais em: Editar um recebedor


Did this page help you?