Refunds

/docs/global/api-reference/refundsGlobal

Issue and list refunds against paid payments.

Authenticated by dashboard session, not an API key

Authorized by your dashboard session bearer token, not an sk_ key — see Authentication. Paths below are relative to https://binkpay.net/api/v1.

Create a refund

POST/api/v1/merchant/refunds

Parameter	Type	Required	Description
paymentId	string	Required	Payment to refund — must be PAID or PARTIAL_REFUND.
amountMinor	string	Required	Amount to refund, in minor units.
reason	string	Optional	Free-text reason for your records.

json

{
 "id": "rfnd_2c9a41",
 "paymentId": "pay_8f2a1c",
 "amountMinor": "5000",
 "status": "PENDING",
 "createdAt": "2026-07-08T15:02:44.000Z"
}

GET/api/v1/merchant/refunds

Newest first. Each row has its own status: PENDING, COMPLETED, or REJECTED.

Was this page helpful?