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 client.Transaction.Refund to refund a transaction.
1

Call the method

Omit the optional body to queue the refund using Core defaults.
client.Transaction.Refund
refund, resp, err := client.Transaction.Refund(
	"txn_c4e70eb8-e4d6-4e04",
)
FieldTypeDescription
transactionIDstringTransaction ID of the applied transaction to refund.
SkipQueueboolWhen true, process the refund synchronously instead of queuing.
2

Save the refund transaction ID

Use refund.TransactionID to track the refund. Check refund.ParentTransactionID to confirm it links to the original transaction.
3

Response

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"
}
FieldTypeDescription
transaction_idstringID of the new refund transaction.
parent_transactionstringOriginal transaction being refunded.
sourcestringOriginal destination, now the source of the refund.
destinationstringOriginal source, now the destination of the refund.
statusstringStatus 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.