Partial Refunds | Coinflow

Merchants can issue multiple partial refunds for a transaction, as long as the total refunded amount does not exceed the original purchase amount.

Partial amounts are set per transaction, so they are only available when refunding one transaction at a time. Batch Refunds always refund the full remaining amount.

Refund from Dashboard

To issue a partial refund from the dashboard:

Locate the payment ID.
Select Refund Transaction.
Enter the refund reason, choose Partial Refund, and specify the refund amount.

After the refund is processed, the updated total refunded amount will be visible the next time you view the payment ID.

How to initiate a refund from merchant dashboard.

How to specify partial refund amount from dashboard.

How to view payment refund details on the payment record from the dashboard.

Refund API

Merchants can call Coinflow’s Refund Payment endpoint to initiate a refund. To view all refund details for a payment, merchants can also call our View Refund Information for Payment endpoint.

Request

$ // Example of how to initiate a partial refund by calling the refund payment endpoint.
$ 
$ 
$ curl --request PUT \
>      --url https://api-sandbox.coinflow.cash/api/merchant/payments/10475192-95e4-4065-bafd-61e564468129/refund \
>      --header 'Authorization: YOUR_API_KEY' \
>      --header 'accept: application/json' \
>      --header 'content-type: application/json' \
>      --data '
> {
>   "refundReason": "buyerFraud",
>   "partialAmount": {
>     "cents": 50 // The amount refunded back to the customer
>   }
> }
> '

Request

$ // Example of how to get refund details after calling view refund information for payment endpoint
$ 
$ 
$ curl --request GET \
>      --url https://api-sandbox.coinflow.cash/api/refunds/payment/10475192-95e4-4065-bafd-61e564468129 \
>      --header 'Authorization: YOUR_API_KEY' \
>      --header 'accept: application/json'

Response

1 {
2   "_id": "689a3e6fd2869c360b8a6016",
3   "totals": {
4     "subtotal": {
5       "cents": 50,
6       "currency": "USD"
7     },
8     "processorFees": {
9       "cents": 21,
10       "currency": "USD"
11     },
12     "total": {
13       "cents": 71,
14       "currency": "USD"
15     },
16     "rate": 1,
17     "resolution": {
18       "cents": 71,
19       "currency": "USD"
20     }
21   },
22   "customer": "6876d4e5f083d1b8aaa9b5f1",
23   "merchant": "6840bca9c7cb21ee5baaae76",
24   "payment": "68924934b967a43c7c70beac",
25   "signature": "0xb2ec7e075af26954ee212a250d0e6a602bd2d0d792eb1af972c46eeaca8a1376",
26   "status": "Settled",
27   "reimbursementStatus": "Complete",
28   "outstanding": {
29     "cents": 0
30   },
31   "source": "Credits",
32   "method": "Card",
33   "provider": "mock",
34   "reason": "buyerFraud",
35   "refundedBy": {
36     "editor": "a59c0b5e41bb491cbaa6dcb38d930aa1",
37     "editorType": "Merchant",
38     "ipAddress": "44.233.151.27"
39   },
40   "createdAt": "2025-08-11T19:03:11.961Z",
41   "updatedAt": "2025-08-11T19:03:11.961Z"
42 }