O objeto recipient representa um recebedor, que irá receber parte da venda realizada. Para criar um pedido com Split de pagamentos, você deve primeiramente cadastrar recebedores. Cada recebedor deve ser criado somente uma vez e poderá ser utilizado em qualquer quantidade de pedidos.
Por exemplo, vamos supor que seu marketplace tem duas lojas cadastradas. Para realizar split entre essas lojas e seu marketplace, você terá que criar três recebedores:
- Marketplace
- Loja 1
- Loja 2
Dessa forma, quando você criar um pedido com Split para a loja 1, você irá enviar o recebedor da loja 1, o recebedor do marketplace e sua regra de divisão para este pedido.
Este objeto possui os seguintes atributos:
Atenção - Mudanças no contrato de recebedores
A partir de 29 de fevereiro de 2024, entrará em vigor um novo contrato para a criação de recebedores. Para obter mais informações, consulte o artigo Novas regras para criação de sellers de Marketplace
Com objetivo de atender as diretrizes dispostas na Circular 3.978/20 do Banco Central sobre os procedimentos a serem adotados para prevenção à lavagem de dinheiro e financiamento ao terrorismo é imprescindível o envio de dados mínimos de cadastro para os sellers dos marketplaces. Com isso iremos disponibilizar novos campos que precisarão ser enviados para a criação de novos recebedores a partir de 31 de março de 2024.
Objeto recipient
| Atributos | Tipo | Descrição |
|---|---|---|
id | string | Código do recebedor. Formato: rp_XXXXXXXXXXXXXXXX. |
name | string | Nome do recebedor. |
email | string | E-mail do recebedor. |
document | string | CPF ou CNPJ do recebedor. |
description | string | Descrição do recebedor. |
type | enum | Tipo de cliente. Valores possíveis: individual (pessoa física) ou company (pessoa jurídica). |
status | string | Status do recebedor. Valores possíveis: registration, affiliation, active, refused, suspended, blocked, inactive |
created_at | datetime | Data de criação do recebedor (UTC). |
updated_at | datetime | Data de atualização do recebedor (UTC). |
default_bank_account | object | Conta bancária do recebedor. |
transfer_settings | object | Informações de transferência do recebedor. |
gateway_recipients | object | Informações do recebedor no gateway. |
metadata | object | Objeto chave/valor utilizado para armazenar informações adicionais sobre o recebedor. Saiba mais sobre metadata |
SPLIT DE PAGAMENTOS SÓ ESTÁ DISPONÍVEL PARA PAGAR.ME
As funcionalidades do Split de Pagamento só estão disponíveis para contas configuradas com a adquirencia Pagar.me
Status do Recebedor
Recebedores podem receber os seguintes status:
registration: Estágio no qual o recebedor já passou pelo pré-credenciamento e está com o auto credenciamento pendente. Aqui ele pode transacionar, mas não pode realizar um saque.
affiliation: Estágio no qual o recebedor já passou pelo auto credenciamento e está esperando a afiliação por parte do Pagar.me. Ele continua podendo transacionar, mas não pode realizar um saque.
active: Estágio no qual o recebedor já passou por todos os estágios do credenciamento e esta apto a transacionar e realizar saques.
refused: Estágio no qual o recebedor foi recusado no pré-credenciamento ou na afiliação. Nesse estágio o recebedor não esta apto a realizar transações e saques.
suspended: Estágio no qual o recebedor não se auto credenciou após um período de dias, ou teve pendências no estágio de afiliação. Nesse estágio o recebedor não esta apto a realizar transações e saques.
blocked: Estágio no qual após ativo, mostrou comportamento suspeito. Nesse estágio o recebedor não esta apto a realizar transações e saques.
inactive: Estágio no qual após ser monitorado, mostrou comportamento suspeito, e comprovamos algo de errado. Nesse estágio o recebedor não esta apto a realizar transações e saques.