Buscar transação
GET
https://api.bestfy.io/transaction/{financialTransactionId}
transactionId ou pixEndToEndId. Caso ambos sejam enviados, a busca prioriza o ID da transação.Estratégia de busca
transactionId único da transação. Lembre-se: você precisa ter permissão de acesso à empresa vinculada a este registro.Exemplo de requisição
Erros comuns
| Código | Motivo |
|---|---|
400 | Requisição sem transactionId e pixEndToEndId |
404 | Transação não encontrada para os filtros enviados |
500 | Erro interno |
Request
Path Params
Header Params
Responses
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request GET 'https://api.bestfy.io/transaction/' \
--header 'User-Agent: <nome-do-projeto>' \
--header 'x-api-key: <api-key>'Response Response Example
{
"transaction": {
"transactionId": "019bc7ea-9f84-0387-7135-f1d6f96bd929",
"status": "PAID",
"deliveryStatus": "PENDING",
"value": 5,
"acquirer": "IUGU",
"createdAt": "2026-01-16T17:46:40.887Z",
"updatedAt": "2026-01-16T17:47:16.767Z",
"paymentConfirmedAt": "2026-01-16T17:46:46.434Z",
"pixEndToEndId": null,
"metadata": "{\"teste\": \"true\"}",
"acquirerId": "B108CFC492974591AE3A4C1D4B517BC4",
"inputAmountInCents": 0,
"outputAmountInCents": 0,
"finalAmountInCents": 0,
"customer": {
"name": "John Doe",
"email": "jonhdoe@email.com",
"cpfCnpj": "423.562.410-51",
"phone": "+55 (51) 99999-9999",
"city": "Porto Alegre",
"neighborhood": "Humaitá",
"postalCode": "90250590",
"state": "RS",
"streetAddress": "Av. Padre Leopoldo Brentano",
"streetNumber": 110
},
"paymentMetadata": {
"method": "CREDIT_CARD",
"value": 5,
"dueDate": null,
"installmentsAmount": 1,
"installmentValue": 5,
"cardBrand": "VISA",
"cardLastDigits": "5422",
"cardHolderName": "JOHN DOE",
"pixCode": null,
"bankSlipUrl": null
},
"cart": [
{
"productId": "019bc7ea-9f5e-b286-61b9-03cf250ea8fa",
"productName": "Produto 1",
"productPriceInCents": 500,
"productQuantity": 1
}
]
}
}Modified at 2026-04-02 20:03:32