Create a withdrawal
Create a PIX withdrawal to transfer BRL funds from your YuvexPay balance. Requires an idempotency key.
The PIX key type (CPF, CNPJ, e-mail, phone, or random key) is detected automatically from destination.pixKey — you do not need to declare it. Invalid keys are rejected with INVALID_PIX_KEY.
The creditor document on the network is always derived server-side from your verified company tax id (CNPJ for business accounts, owner CPF for individual accounts).
Withdrawals may be blocked outside business hours or if your account has restrictions.
Authorizations
YuvexPay API key. Include as Authorization: Bearer ypk_<env>_<kid>_<secret> where <env> is test (sandbox) or live (production). Create and manage keys in the dashboard under Settings > API Keys.
Headers
A unique string to ensure the request is processed only once. Must be unique per request. Valid for 24 hours.
100Body
Withdrawal amount (minimum R$10.00).
10 <= x <= 1000000Must be a multiple of 0.01Where to send the funds.
Public withdrawals currently support PIX only.
PIX BRL Internal description for this withdrawal.
500Response
Withdrawal created.

