Carteiras
Sua conta pode ter várias carteiras na mesma moeda. Os saldos ficam aqui; os saques saem de uma carteira gastável da moeda.
Listar carteiras
GET /v1/wallets
curl 'https://v2.pagnow.com/v1/wallets' \
-H 'apikey: pnk_sua_chave_aqui'Retorna cada carteira com id, currency, label, walletType, isDefault,
isActive, createdAt, balance e pendingBalance (valores em centavos).
Consultar uma específica:
curl 'https://v2.pagnow.com/v1/wallets/{id}' \
-H 'apikey: pnk_sua_chave_aqui'Criar carteira
POST /v1/wallets — você mesmo pode criar carteiras adicionais na sua conta.
curl -X POST 'https://v2.pagnow.com/v1/wallets' \
-H 'apikey: pnk_sua_chave_aqui' \
-H 'content-type: application/json' \
-d '{
"currency": "BRL",
"walletType": "SPENDABLE",
"label": "Carteira de reserva"
}'| Campo | Tipo | Notas |
|---|---|---|
currency | string | Moeda da carteira (ex: BRL, USDT). |
walletType | string | Tipo da carteira (ex: SPENDABLE). |
label | string | Nome descritivo para identificação. |
Carteira padrão
Cada moeda tem uma carteira padrão: é onde o dinheiro recebido (cash-in) é creditado e a carteira usada no saque quando você não informa qual. Entre em contato com a PagNow para alterar qual carteira é a padrão.
Endpoints de saldo e extrato
| Método | Caminho | Finalidade |
|---|---|---|
GET | /v1/wallets/balance | Saldo consolidado por moeda. |
GET | /v1/wallets/summary | Resumo financeiro (entradas, saídas, saldo). |
GET | /v1/wallets/statement | Extrato de movimentações. |
GET | /v1/wallets/balance-history | Histórico de saldo ao longo do tempo. |
# Saldo consolidado
curl 'https://v2.pagnow.com/v1/wallets/balance' \
-H 'apikey: pnk_sua_chave_aqui'
# Extrato
curl 'https://v2.pagnow.com/v1/wallets/statement' \
-H 'apikey: pnk_sua_chave_aqui'Saque de uma carteira específica
No POST /v1/withdrawals, envie walletId para debitar uma carteira específica.
Se omitir, o saque usa a carteira padrão da moeda (ou qualquer carteira gastável
com saldo suficiente).
curl -X POST 'https://v2.pagnow.com/v1/withdrawals' \
-H 'apikey: pnk_sua_chave_aqui' \
-H 'content-type: application/json' \
-d '{ "type": "PIX", "amount": 10000, "currency": "BRL", "walletId": "<id>", "pixKey": "maria@exemplo.com", "pixKeyType": "EMAIL" }'