Buscar transação
Developing
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 'x-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":"João Pedro Teste de Webhook","email":"jpteste@gmail.com","cpfCnpj":"85312690082","phone":"+55 (51) 99927-3042","city":"Porto Alegre","neighborhood":"Sarandi","postalCode":"91110160","state":"RS","streetAddress":"Nehita Martins Ramos","streetNumber":null},"paymentMetadata":{"method":"CREDIT_CARD","value":5,"dueDate":null,"installmentsAmount":1,"installmentValue":5,"cardBrand":"VISA","cardLastDigits":"5928","cardHolderName":"JOAO SILVA","pixCode":null,"bankSlipUrl":null},"cart":[{"productId":"019bc7ea-9f5e-b286-61b9-03cf250ea8fa","productName":"Produto 1","productPriceInCents":500,"productQuantity":1}]}}Modified at 2026-01-27 19:57:10