APapaleo
FolioPayments

Trigger a refund for the folio.

Trigger a generic refund for the folio. The refund will be processed asynchronously. Use the location header to poll for the status of the refund. As long as a refund is pending it reduces the amount of allowed refunds for the folio. The refund times out after 60 minutes automatically<br>You must have this scope: 'folios.manage'.<br>For fine-grained clients, you must have this permission: 'core.folio_refunds.create'.

post/finance/v1/folios/{folioId}/refunds

Request

  • Base URL
    https://api.apaleo.com (the document declares no server; this is the origin it was published from)
  • URL
    https://api.apaleo.com/finance/v1/folios/{folioId}/refunds
  • Auth
    OAuth 2
    Implicit: https://identity.apaleo.com/connect/authorize
    Scopes: folios.manage, admin

Path parameters

folioIdstring required

Headers

Idempotency-Keystring

Unique key for safely retrying requests without accidentally performing the same operation twice. We'll always send back the same response for requests made with the same key, and keys can't be reused with different request parameters. Keys expire after 24 hours.

Request body

method'Cash' | 'BankTransfer' | 'CreditCard' | 'Amex' | 'VisaCredit' | 'VisaDebit' | 'MasterCard' | 'MasterCardDebit' | 'Maestro' | 'GiroCard' | 'DiscoverCard' | 'Diners' | 'Jcb' | 'BookingCom' | 'VPay' | 'PayPal' | 'Postcard' | 'Reka' | 'Twint' | 'Lunchcheck' | 'Voucher' | 'ChinaUnionPay' | 'Other' | 'Cheque' | 'Airbnb' | 'HolidayCheck' | 'Representation' | 'IDeal' required

The payment method the refund will be accounted to

receiptstring nullable

The receipt for the refund

businessDatestring date nullable

The business date of the refund. Defaults to the current date. In some cases you might want to post the refunds to the previous business date, this is only possible until 6 AM of the current day.

reasonstring nullable

The reason for payment refund

Example request

{
  "method": "Cash",
  "amount": {
    "amount": 10,
    "currency": "EUR"
  },
  "receipt": "CSH-201824120003",
  "businessDate": "2026-10-23",
  "reason": "Refund for the cancelled service"
}

Response

Refund was created and will be processed.

idstring required

Changes

No recorded changes to this operation across all 3 revisions of this API.