Pix key formats

Withdrawals require a key_type and a matching key. Use these formats to avoid rejections.

Supported key types

Name
CPF
Type
key_type
Description
11 digits, numbers only.
Hyphens/dots are rejected.
Example: 95876150096
Name
CNPJ
Type
key_type
Description
14 digits, numbers only.
Hyphens, slashes, and dots are rejected.
Example: 33400689000109
Name
PHONE
Type
key_type
Description
E.164 with country code and no spaces or punctuation.
Example: +5511999999999
Name
EMAIL
Type
key_type
Description
Standard email format.
Lowercase is recommended.
Example: finance@example.com
Name
EVP
Type
key_type
Description
UUID (random Pix key).
Hyphens are accepted.
Example: 17ce9060-b29d-4ab5-89cd-20550ce6e7ac

Request

POST

/api/withdrawals

curl --request POST \
  --url https://my.domain.io/api/withdrawals \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --header 'x-token: <api-key>' \
  --header 'idempotency-key: <unique-key>' \
  --data '{
  "amount": 100.00,
  "key": "95876150096",
  "key_type": "cpf",
  "transfer_method": "Pix"
}'

Validation tips

Validate and sanitize user input before calling POST /api/withdrawals to prevent soft failures.

Key Type	Format	Invalid Examples
CPF	11 digits only	`958.761.500-96`, `958-761-500-96`
CNPJ	14 digits only	`33.400.689/0001-09`
PHONE	+55 + DDD + number	`(11) 99999-9999`, `11 99999-9999`
EMAIL	Valid email	Case doesn't matter, but lowercase recommended
EVP	UUID format	Must be valid UUID