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
accountId
Account 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).
Request
This endpoint expects an object.
network
address
label
Response
Wallet screened
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
409
Conflict Error
422
Unprocessable Entity Error