1. Transações
Bestfy API
  • Sobre a Bestfy
    • Comece aqui
  • Webhooks
    • O que é um Webhook?
  • Status de transação
    • Status de Pagamento na Bestfy
  • Transações
    • Criar transações
      POST
    • Estornar transação
      POST
    • Buscar transação
      GET
    • Listar transações
      GET
  • Saldo
    • Buscar saldo
      GET
  • API Key
    • Validar API Key
      GET
  1. Transações

Estornar transação

POST
https://api.bestfy.io/transaction/{financialTransactionId}/refund
Use este endpoint para iniciar o reembolso de uma transação financeira já existente.
O processamento é assíncrono e a resposta apenas confirma o aceite do pedido.

Autenticação#

x-api-key (obrigatório)
Chave da empresa para acesso público ao endpoint.

Regras de uso#

A transação deve existir.
A transação precisa estar com status PAID.
O método de pagamento não pode ser boleto.
O reembolso não pode estar em processamento.
Quando autenticado via API key (perfil de producer):
O usuário deve pertencer à empresa da transação.
A empresa deve permitir reembolso (chargebackEnabled).
A empresa precisa ter saldo disponível suficiente.

Parâmetros da Requisição#

Path Params#

financialTransactionId (string, obrigatório)
Identificador da transação financeira que será reembolsada.

Headers#

x-api-key (string, obrigatório)
Chave de autenticação da empresa.
Authorization (string, opcional)
Token Bearer de usuário autenticado.

Exemplo de Requisição (API Key)#

Request

Path Params

Header Params

Responses

🟢202Reembolso da transação iniciado com sucesso
application/json
Body

🟠400Regras de negócio não atendidas
🟠401 API key ou token inválido/ausente.
🟠403Acesso negado à empresa da transação
🟠404Transação, empresa ou metadados de pagamento não encontrados
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://api.bestfy.io/transaction//refund' \
--header 'User-Agent: <nome-do-projeto>' \
--header 'x-api-key: <api-key>' \
--header 'Content-Type: application/json'
Response Response Example
202 - Success
{
    "message": "Reembolso de transação iniciado com sucesso"
}
Modified at 2026-04-02 20:03:38
Previous
Criar transações
Next
Buscar transação
Built with