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 |
| 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 comodaily, o recebedor terá saque diário, portanto não é necessário informar o parâmetrotransfer_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
Updated over 2 years ago