Fetch Charges
POST - https://dominio.com.br/api/fetch-charges/
The Fetch Charge by TXID endpoint in the ENV Bank allows users to retrieve detailed information about a specific charge using its unique transaction identifier (TXID). This feature is valuable for monitoring the status, details, and associated transactions of a specific payment request.
🚧 HEADERS
Authorization (string, required): The access token generated by the authentication endpoint must be included in the authorization header in the format Bearer .
➡️ Practical Tips
Pagination: Use the page parameter to manage the pagination of results, especially if you expect a large volume of transactions.
TXID: Make sure you use the correct TXID and in the appropriate format to avoid errors. The TXID is a unique identifier for each transaction, made up of letters and numbers.
Authentication: Always include the authorization header with a valid token.
Error Handling:
Billing Monitoring: Use this endpoint to monitor and check the status of specific charges regularly, especially in applications that rely on real-time payment updates.
Body Params
txid string required
Exemplo:
curl --request POST \
--url https://dominio.com.br/api/fetch-charges/ \
--header 'accept: application/json' \
--header 'content-type: application/json' \
--header 'Authorization: Bearer XXXXXXXXXXXXXXXXXXXXXXXXXXXX' \
--data '
{
"txid": "XXXXXXXXXXXXXXXXXXXXXXXXXXXX"
}
'
Resposta: 200
{
"txid": "ENV01001962503000000238120000000054",
"status": "PAID",
"created_at": "2025-08-18T19:33:50.363Z",
"paid_at": "2025-08-18T19:33:50.364Z",
"amount": "0.01",
"pix_cash_in": {
"end_to_end_id": "E31872495202508181808AfyNKUcA2xw",
"sender": null
}
Resposta 400:
{
"error_code": "VAL009",
"reason": "Falha: o TXID informado não existe no sistema."}
