Skip to main content
Use order refunds when a customer needs a full or partial refund for a paid Kyren Pay order. Refunds start as a merchant refund request and are reviewed before Kyren Pay attempts the refund.

​
When you can request a refund

You can request a refund from the order detail page when all of these are true:
  • Your merchant account has refund access enabled.
  • The order status is PAID or SETTLED.
  • The order is not an onboarding fee order.
  • The refund amount is greater than 0 and does not exceed the remaining refundable amount.
  • The order does not already have an active refund request in PENDING or REVIEWING.
If the Request refund button is not visible, check the order status and whether refund access is enabled for your account.

​
Request a refund

  1. Open Dashboard > Orders.
  2. Select the order you want to refund.
  3. Click Request refund.
  4. Enter the refund amount and reason.
  5. Submit the request.
After submission, the request appears in the refund request table on the order detail page.

​
Refund request statuses

​
Refund record statuses

​
Balance and reconciliation

When a refund succeeds, Kyren Pay records a refund deduction in your funds and updates the order refund status. Review the order detail page, transaction records, and your own fulfillment system together. If your system fulfills automatically, handle refund updates idempotently and reverse or adjust the customer entitlement according to your own product policy.

​
Webhook notification

When a refund is applied to an order, Kyren Pay sends the order.refunded Webhook event. Use this event to update entitlement, balance, or reconciliation records in your system.

​
Epay compatibility

Use /epay/api.php?act=refund only for orders created through Epay compatibility endpoints and only when your merchant account has refund access enabled. Native Kyren API orders should use the native refund API, while manual operational refunds can still be handled from the dashboard.