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
accountId
Account identifier.
walletId
P2P wallet identifier.
Headers
X-Tenant-Id
Tenant context used for authorization and routing.
X-Acting-Document
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-Key
Optional client-generated idempotency token (recommended for safe retries).
Response
Wallet
walletId
Wallet identifier.
network
Network.
address
Address.
label
Your label.
screeningStatus
Risk screening result. Only approved trades.
Allowed values:
screeningFlags
Screening flags, when any.
isDefault
Default wallet for new orders.
defaultEffectiveAt
When a pending default takes effect.
screenedAt
Screening time.
createdAt
Registration time.
Errors
403
Forbidden Error
404
Not Found Error
422
Unprocessable Entity Error