Skip to main content
/epay/api.php provides Epay-compatible operational actions. Use act=order to query migrated Epay-style orders. Use act=refund to submit refunds for eligible Epay-source orders.

Order query

Call GET or POST /epay/api.php?act=order with pid, raw merchant key, and one of out_trade_no or trade_no. This endpoint uses the raw merchant key with pid for compatibility order query. It may be subject to the API IP allowlist when enabled.
Example success response:
addtime and endtime are Epay-compatible datetime strings when exposed by this compatibility query. Example failure response:

Refund compatibility

Call GET or POST /epay/api.php?act=refund with pid, raw merchant key, money, and one of out_trade_no or trade_no. Refunds through this path are only for orders created by Epay compatibility endpoints. Native Kyren API orders should use the native refund API. The merchant account must have refund access enabled, and the order must still have enough refundable amount. Optional refund_no is used for idempotency. If omitted, Kyren uses the order ID and normalized refund amount as the compatibility idempotency key.
Example response:
See the api.php API reference.