curl https://api.liddie.io/api/v1/payments/<paymentId>/refunds \
-H "Authorization: Bearer lid_live_..."
const response = await fetch('https://api.liddie.io/api/v1/payments/<paymentId>/refunds', {
headers: { 'Authorization': 'Bearer lid_live_...' },
});
const { ok, data } = await response.json();
{ "ok": true, "data": { "refunds": [], "refundable": "0", "eligible": false, "currency": "DOGE" } }
Refunds
List refunds for a payment
List a Liddie payment’s refund history and the authoritative remaining-refundable amount before issuing a new crypto refund on the same payment.
GET
/
api
/
v1
/
payments
/
{paymentId}
/
refunds
curl https://api.liddie.io/api/v1/payments/<paymentId>/refunds \
-H "Authorization: Bearer lid_live_..."
const response = await fetch('https://api.liddie.io/api/v1/payments/<paymentId>/refunds', {
headers: { 'Authorization': 'Bearer lid_live_...' },
});
const { ok, data } = await response.json();
{ "ok": true, "data": { "refunds": [], "refundable": "0", "eligible": false, "currency": "DOGE" } }
Returns the refund rows for a payment and the authoritative remaining-refundable amount — call it before refunding so you know exactly how much is left.
curl https://api.liddie.io/api/v1/payments/<paymentId>/refunds \
-H "Authorization: Bearer lid_live_..."
const response = await fetch('https://api.liddie.io/api/v1/payments/<paymentId>/refunds', {
headers: { 'Authorization': 'Bearer lid_live_...' },
});
const { ok, data } = await response.json();
{ "ok": true, "data": { "refunds": [], "refundable": "0", "eligible": false, "currency": "DOGE" } }
Authorization
API key scoperefunds:read or dashboard JWT with team permission refunds:view. Rate limit 60/min.
Parameters
string
required
ID of the payment whose refund history to fetch.
Call this before Create a refund:
refundable is the authoritative remaining-refundable amount, and eligible tells you up front whether a refund attempt can succeed at all.Response
array
The refund rows for this payment.
string
The authoritative remaining-refundable amount, as a decimal string.
boolean
Whether the payment can currently be refunded.
string
The payment’s currency — refunds are always made in it.
Errors
Attempting to refund a non-settled payment fails safely on Create a refund:| Status | Body | Why |
|---|---|---|
| 400 | {"ok":false,"error":{"code":"NOT_REFUNDABLE","message":"This payment cannot be refunded"}} | The payment is not settled. |
See also
- Create a refund: issue a refund once
eligibleistrue. - Get a refund: poll a single refund row by its
id. - Route map: every refund endpoint at a glance.