Skip to navigation

Make a wallet the default

Marks an approved wallet as the default for new orders. The change takes effect after the tenant’s cooldown (defaultEffectiveAt), so a stolen session cannot redirect the next delivery at once.

Authentication

AuthorizationBearer

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

Path parameters

accountIdstringRequired
Account identifier.
walletIdstringRequired
P2P wallet identifier.

Headers

X-Tenant-IdstringRequired
Tenant context used for authorization and routing.
X-Acting-DocumentstringOptional

CPF of the human performing the operation. Required on cashout routes when the credential enforces a transaction PIN. On a company P2P profile contact, this CPF is the holder who signs; it is not taken from the body.

Idempotency-KeystringOptional

Optional client-generated idempotency token (recommended for safe retries).

Response

Wallet
walletIdstringOptional
Wallet identifier.
networkstringOptional
Network.
addressstringOptional
Address.
labelstringOptional
Your label.
screeningStatusenumOptional

Risk screening result. Only approved trades.

Allowed values:
screeningFlagslist of stringsOptional
Screening flags, when any.
isDefaultbooleanOptional
Default wallet for new orders.
defaultEffectiveAtdatetime or nullOptional
When a pending default takes effect.
screenedAtdatetime or nullOptional
Screening time.
createdAtdatetime or nullOptional
Registration time.

Errors

403
Forbidden Error
404
Not Found Error
422
Unprocessable Entity Error