Get transaction

POST/api/v1/gateway/walletTransaction

Looks up a charge (PIX_IN) or payout (PIX_OUT) on your account. Send one identifier: requestNumber (yours, for charges), idTransaction (WeetPay's) or endToEnd (the PIX E2E id). Payouts are found by idTransaction or endToEnd.

Pending charges are re-checked with the bank on lookup (at most every 10 s), so this also works as a fallback if a callback is lost. Still, prefer callbacks: do not poll in a loop.

Authorization

vspi<token>

Client ID (e.g. weetpay-100123). Also accepted as x-client-id.

In: header

vsps<token>

Client secret. Also accepted as x-client-secret. Never expose it in front-end code.

In: header

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Send at least one field

Response Body

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"  }}