List refunds

GET/v1/refunds

Key scope: read

Refunds, with each payout's state, fee, receipt and transaction hash.

Query parameters

payment string: Only refunds of this payment.

Errors

403 refunds_merchant_only
401 api_key_required
401 api_key_invalid
401 api_key_wrong_mode
403 scope_missing
429 rate_limited

All codes: Errors.

Request

curl "https://wallet.simpleeasytransactions.com/v1/refunds" \
  -H "Authorization: Bearer $SET_API_KEY"

Response 200

{
  "object": "list",
  "data": [ {
      "id": "rf_…",
      "object": "refund",
      "payment": "…",
      "paymentKind": "cash_out_payment",
      "invoice": "inv_3b1f…",
      "payout": "po_3c8e1a7f5b2d4e6f9a0b1c2d3e4f5a6b",
      "amount": "25.00",
      "currency": "usdc",
      "paymentCurrency": "usdc",
      "state": "payment_processed",
      "fee": "0.38",
      "receiptAmount": "24.62",
      "txHash": "0x…",
      "livemode": true,
      "createdAt": "2026-11-08T15:04:05.000Z",
      "updatedAt": "2026-11-08T15:04:05.000Z"
    } ],
  "hasMore": false
}