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

Authorizations

Authorization
string
header
required

JWT bearer token issued by the identity provider.

Headers

X-Idempotency
string
required

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

Body

application/json
agentAccountId
string
required

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
required

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.

Response

OK

active
boolean
required

True while the channel instructs; false parks issuance.

agentAccountId
string
required

The agent's receiving account.

agentName
string
required

The appointed collection agent.