Skip to main content
PUT
Appoint the tenant's extraordinary-collection agent

Autorizaciones

Authorization
string
header
requerido

JWT bearer token issued by the identity provider.

Encabezados

X-Idempotency
string
requerido

Canonical idempotency request ID. Required: this request moves money, and without a key a retry cannot be told apart from a second instruction.

Cuerpo

application/json
agentAccountId
string
requerido

The collection agent's own receiving account, held at the agent and never an account of the lender's: the agent receives the borrower's cash and the lender ingests the settlement file. It becomes the payment identity of every settlement of the instructions it stamps, so it admits no colon, whitespace or control character — "conta byx 001" is refused here, where a 422 costs nothing, instead of stranding a paid borrower's money later.

Required string length: 1 - 255
Pattern: ^[^\s:\x00-\x1f\x7f]+$
agentName
string
requerido

The collection agent, lowercase authority shape. It is stamped VERBATIM on every instruction and the baixa file quotes it back byte-exactly, so mixed case would issue instructions no file could answer.

Required string length: 1 - 100
Pattern: ^[a-z0-9][a-z0-9._-]{0,99}$
active
boolean

Defaults to true. False turns the channel OFF without deleting the agent's identity, returning issuance to the park; an instrument already issued still names the agent that received it.

Respuesta

OK

active
boolean
requerido

True while the channel instructs; false parks issuance.

agentAccountId
string
requerido

The agent's receiving account.

agentName
string
requerido

The appointed collection agent.