> ## Documentation Index
> Fetch the complete documentation index at: https://developers.javalibridge.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Beneficiários e instruções de pagamento

> Beneficiários são as pessoas e empresas no Brasil que recebem seus pagamentos. A LB Pay não os cadastra como clientes próprios. Em vez disso, cada instrução de pagamento (chave Pix) que você registra passa por uma triagem antes de poder ser usada em uma remessa.

## Como cadastrar

1. Envie os dados do beneficiário: tipo (pessoa física ou jurídica), CPF ou CNPJ, nome (ou razão social), endereço, tipo de relação e ao menos uma chave Pix.
2. Cada chave Pix entra em `SCREENING` e a LB Pay faz a triagem automaticamente.
3. Você é notificado por `beneficiary.status_changed` quando cada chave fica `APPROVED` ou `REJECTED`.
4. Para adicionar ou desativar uma chave Pix depois, atualize o beneficiário.

> [!NOTE]
>
> Você pode pagar um beneficiário quando ele está `ACTIVE` e a chave Pix está `APPROVED`.

| Status do beneficiário | Significado |
| - | - |
| `ACTIVE` | Pode receber |
| `BLOCKED` | Não pode receber |
| `INACTIVE` | Desativado por você |

| Status da chave Pix | Significado |
| - | - |
| `SCREENING` | Em triagem; ainda não pode receber |
| `APPROVED` | Pode receber |
| `REJECTED` | Não passou na triagem. Os motivos não são detalhados. |
| `INACTIVE` | Desativada; o histórico é mantido |

## O que a LB Pay verifica

* Identidade: CPF ou CNPJ, nome completo (ou razão social) e país do beneficiário são verificados contra listas de sanções e de PEP.
* Chave Pix: a chave precisa existir no diretório do Pix antes de ser aprovada.

A primeira chave de um beneficiário novo passa pela triagem completa. As chaves seguintes do mesmo beneficiário passam por uma verificação mais leve, focada na nova chave. Alterar dados de identidade (nome, documento ou endereço) dispara uma nova triagem.

Na criação do withdrawal, a LB Pay verifica de novo se a chave existe. Logo antes do Pix, a LB Pay confirma que o documento do titular da chave corresponde ao beneficiário. Se não corresponder, o Pix não é enviado e a remessa vai para `FUNDS_HELD_BRL`.

## O que continua com você

A LB Pay faz a triagem dos dados enviados; ela não verifica a pessoa por trás deles. Continua sendo sua responsabilidade:

* verificar a identidade de cada usuário final antes que ele envie ou receba pela LB Pay;
* manter seus próprios registros de identificação (documentos, comprovante de endereço e, quando aplicável, origem dos recursos), conforme exigido pelos seus reguladores;
* garantir que os dados do beneficiário enviados correspondam aos que você coletou;
* aplicar seus próprios limites e níveis de risco. A triagem da LB Pay é um controle de pagamento, não substitui a sua diligência sobre o cliente.

Se o seu regime regulatório exigir que a LB Pay participe da revisão do cliente, fale com o time de compliance da LB Pay. Esses arranjos são negociados à parte.

## Relação com o remetente

| Tipo de relação | Significado | Relação aceita na remessa |
| - | - | - |
| `SELF_OWNED` | O beneficiário é o próprio remetente, recebendo em conta própria no Brasil | Só `SELF` |
| `THIRD_PARTY` | Outra pessoa ou empresa | Qualquer uma, exceto `SELF` |

A relação detalhada com o remetente (família, amigo, empregador…) é informada em cada remessa, porque um beneficiário de terceiro pode receber de remetentes diferentes.

> [!TIP]
>
> **O que você faz**
>
> * Cadastre o beneficiário com endereço, tipo de relação e uma chave Pix que seja dele.
> * Aguarde a chave ficar `APPROVED` antes de criar um withdrawal.
> * Informe na remessa uma relação coerente com o tipo do beneficiário.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.