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).

X-Request-TimestampstringRequired

Unix seconds. Required on the signed host; tolerance is 300s either way (403 request_timestamp_skew).

X-Content-SHA256stringRequired

Lowercase hex SHA-256 of the body. An empty body hashes the empty string, so the header is always present. Mismatch returns 400 body_hash_mismatch.

X-Request-SignaturestringRequired

Detached JWS (<protected>..<signature>, ES256 or PS256) over METHOD\nPATH?QUERY\nTIMESTAMP\nIDEMPOTENCY_KEY_OR_EMPTY\nX_CONTENT_SHA256.

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