Consultar transação

POST/api/v1/gateway/walletTransaction

Consulta uma cobrança (PIX_IN) ou um saque (PIX_OUT) da sua conta. Informe um dos identificadores: requestNumber (o seu, da cobrança), idTransaction (o da WeetPay) ou endToEnd (o E2E do PIX). Saques são encontrados por idTransaction ou endToEnd.

Cobranças pendentes são conferidas no banco a cada consulta (no máximo a cada 10 s), então a consulta também serve de contingência caso um callback se perca. Mesmo assim, prefira o callback: não consulte em loop.

Autenticação

vspi<token>

Client ID (ex.: weetpay-100123). Também aceito como x-client-id.

Em: header

vsps<token>

Client secret. Também aceito como x-client-secret. Nunca exponha no front-end.

Em: header

Corpo da requisição

application/json

Definições TypeScript

Use o tipo request body no TypeScript.

Informe pelo menos um dos campos

Corpo da resposta

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X POST "https://example.com/api/v1/gateway/walletTransaction" \  -H "Content-Type: application/json" \  -d '{    "requestNumber": "pedido-12345"  }'
{  "transaction": {    "id": "cmh1x2y3z0001ab12cd34ef56",    "created_at": "2026-10-30T13:02:11.000Z",    "approvedDate": "2026-10-30T13:03:40.000Z",    "transactionType": "PIX_IN",    "destination": null,    "destinationBank": null,    "processingStatus": "PAID_OUT",    "idTransaction": "cmh1x2y3z0001ab12cd34ef56",    "idTransactionProvider": "E18236120202610301303s0123456789",    "callbackUrl": "https://sualoja.com.br/webhooks/weetpay",    "userSplit": null,    "porcentageSplit": null,    "amount": "49.90",    "requestNumber": "pedido-12345",    "account_id": 100123,    "debtorName": "MARIA DA SILVA",    "debtorDocument": "***.456.789-**",    "pixCopiaECola": null,    "endToEnd": "E18236120202610301303s0123456789"  }}