Integração - Fetch Charges by TXID

Fetch Charges

ENDPOINT - https://dominio.com.br/api/fetch-cach-out/

The Fetch a Cash-out by Correlation ID endpoint in the ENV Bank API allows users to retrieve detailed information about a specific cash-out transaction based on its unique correlation ID. This feature is particularly useful for tracking and reviewing cash-out transactions associated with a specific correlation ID.

🚧 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

Correlation Validation: Verify that the correlation ID is correctly associated with the desired withdrawal transaction.

Body Params

correlation_id string required
correlation_id (string, required): Correlation ID of the withdrawal transaction you want to consult.

Exemplo:

curl --request POST \
--url https://dominio.com.br/api/fetch-cach-out/ \
--header 'accept: application/json' \
--header 'content-type: application/json' \
--header 'Authorization: Bearer XXXXXXXXXXXXXXXXXXXXXXXXXXXX' \
--data '
{
"correlation_id": "XXXXXXXXXXXXXXXXXXXXXXXXXXXX"
}

Resposta  200

{

"status": "DONE",
"created_at": "2025-08-18T19:29:00.104Z",
"paid_at": "2025-08-18T19:29:00.104Z",
"amount": "10.00",
"end_to_end_id": "EEW720544720250818131302947c915",
"correlation_id": "XXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
"recipient_account_bank_ispb": "33333333",
"recipient_account_branch": "0000",
"recipient_account_number": "0000",
"recipient_account_type": "TRAN",
"recipient_document_number": "34234333223322322",
"recipient_name": "ENV BANK"
}

Resposta 400:

{
"error_code": "VAL009",
"reason": "Falha: o correlation_id informado não existe no sistema."
}