Skip to main content
POST
/
transactions
/
{transactionId}
/
refunds
Estornar transação
curl --request POST \
  --url https://api.conta.paybeehive.com.br/v1/transactions/{transactionId}/refunds \
  --header 'Authorization: Basic <encoded-value>' \
  --header 'Content-Type: application/json' \
  --data '{
  "amount": 5000
}'
{
  "id": 999,
  "amount": 5000,
  "createdAt": "2026-01-04T12:10:00Z"
}

Authorizations

​
Authorization
string
header
required

Basic Authorization usando SECRET_KEY como usuário e "x" como senha.

Headers

​
Idempotency-Key
string

Chave de idempotência para evitar duplicidade em retries.

Path Parameters

​
transactionId
integer<int32>
required

Body

application/json
​
amount
integer

Valor em centavos. Se omitido, estorna total.

Example:

5000

Response

Estorno criado

​
id
integer
Example:

999

​
amount
integer
Example:

5000

​
createdAt
string
Example:

"2026-01-04T12:10:00Z"