PayZu CâmbioOperações
Cadastrar a carteira
O saque só vai para uma carteira cadastrada na conta.
Crie a carteira
Informe o nome, o endereço e a rede, com um Idempotency-Key.
bash
curl -X POST https://api.exchange.payzu.com.br/v1/wallets \
-H "Authorization: Bearer SUA_CHAVE_DE_API" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: 0b6f1d0a-2c5e-4a7f-8a3d-9e1c4b7f2a10" \
-d '{
"label": "Tesouraria",
"address": "TSeuEnderecoTRC20xxxxxxxxxxxxxxxxx",
"network": "TRC20"
}'json
{
"id": "5f0c2a7e9b1d4c38",
"label": "Tesouraria",
"network": "TRC20",
"address": "TSeuEnderecoTRC20xxxxxxxxxxxxxxxxx",
"createdAt": "2026-11-10T12:00:00.000Z"
}Referência: Criar carteira
O id da resposta identifica a carteira em Simular o saque e em Criar o saque.
Erros da carteira
| Código | HTTP | Em details |
|---|---|---|
invalid_address | 400 | - |
invalid_checksum | 400 | - |
invalid_label | 400 | - |
account_blocked | 403 | - |
address_exists | 409 | walletId da carteira que já tem o endereço |
address_limit | 409 | max |
label_exists | 409 | - |
Os demais códigos estão no Catálogo de erros.