Skip to navigation

Register a P2P wallet

Registers a wallet and screens it for risk (Elliptic, synchronous). 201 carries the result; 202 means screening is still running and p2p.wallet.screened will follow. Only approved wallets trade. The first approved wallet becomes the default. Scope p2p.wallets.

Authentication

AuthorizationBearer

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

Path parameters

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

Request

This endpoint expects an object.
networkstringRequired
addressstringRequired
labelstringOptional<=60 characters

Response

Wallet screened
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
409
Conflict Error
422
Unprocessable Entity Error