Skip to main content
POST
/
refund-transaction
/
{transaction_id}
Refund transaction
curl --request POST \
  --url http://localhost:5001/refund-transaction/{transaction_id} \
  --header 'X-blnk-key: <api-key>'
Use blnk.Transactions.refund to refund a transaction.
blnk.Transactions.refund
const response = await blnk.Transactions.refund(
  'txn_c4e70eb8-e4d6-4e04-a2e2-92a43b969e0c',
);
FieldDescription
transactionIdTransaction ID of the applied transaction to refund.
skip_queueWhen true, process the refund synchronously instead of queuing.

Response shape

201 Created
{
  "amount": 1250.34,
  "rate": 0,
  "precision": 100,
  "precise_amount": 125034,
  "transaction_id": "txn_c4e70eb8-e4d6-4e04-a2e2-92a43b969e0c",
  "parent_transaction": "txn_c4e70eb8-e4d6-4e04-a2e2-92a43b969e0c",
  "source": "bln_f344b673-e855-4bda-b769-3e94a02c1941",
  "destination": "@WorldUSD",
  "reference": "ref_2ye281ewiu",
  "currency": "USD",
  "description": "Card payment on Stripe",
  "status": "QUEUED",
  "hash": "0b9c25fb5b00d6c71cb4ca87026bf6dc316e63353d3330deb588bd0b3d74dcc0",
  "created_at": "2024-11-26T09:33:35.265582042Z"
}
FieldDescription
transaction_idID of the new refund transaction.
parent_transactionOriginal transaction being refunded.
sourceOriginal destination, now the source of the refund.
destinationOriginal source, now the destination of the refund.
statusStatus of the refund transaction.

Refunds

Reversal behavior and edge cases.

Refund transaction

HTTP request and response schema.

Need help?

We are very happy to help you make the most of Blnk, regardless of whether it is your first time or you are switching from another tool. To ask questions or discuss issues, please contact us or join our Discord community.