Pular para o conteúdo principal
GET
Consultar beneficiário com instruções e status de triagem

Autorizações

Authorization
string
header
obrigatório

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Parâmetros de caminho

beneficiaryId
string
obrigatório

Resposta

Beneficiary

relationshipType
enum<string>
obrigatório

Titularidade da conta de destino. SELF_OWNED: o beneficiário é a mesma pessoa que o remetente (conta própria no Brasil). THIRD_PARTY: o beneficiário é outra pessoa ou empresa. No withdrawal, SELF_OWNED exige senderRelationship = SELF e THIRD_PARTY não aceita SELF.

Opções disponíveis:
SELF_OWNED,
THIRD_PARTY
entity
object
obrigatório

INDIVIDUAL exige firstName e lastName; BUSINESS exige businessName. Endereço obrigatório para a triagem.

beneficiaryId
string
obrigatório
status
enum<string>
obrigatório

Situação do cadastro. Pode receber se ACTIVE e com ao menos uma instrução APPROVED.

Opções disponíveis:
ACTIVE,
BLOCKED,
INACTIVE
paymentInstructions
object[]

Ao menos uma instrução APPROVED é necessária para criar um withdrawal para este beneficiário.

createdAt
string<date-time>
updatedAt
string<date-time>