Skip to main content
POST
/
epay
/
api.php
curl --request POST \
  --url https://api.kyren.top/epay/api.php \
  --header 'Content-Type: application/x-www-form-urlencoded' \
  --data act=order \
  --data pid=merch_001 \
  --data key=merchant_raw_api_key \
  --data out_trade_no=order_20260409002
{
  "code": 1,
  "msg": "查询订单号成功!",
  "trade_no": "order_epay_001",
  "out_trade_no": "order_20260409002",
  "type": "wxpay",
  "pid": "merch_001",
  "addtime": "2026-04-09 06:10:20",
  "endtime": "2026-04-09 06:11:08",
  "name": "AI Credits 1000",
  "money": "9.99",
  "status": 1,
  "param": "user_42",
  "buyer": ""
}

Body

application/x-www-form-urlencoded
act
enum<string>
required

API action. refund currently returns unsupported message.

Available options:
order,
refund
pid
string
required

Merchant ID

key
string
required

Merchant raw API key (not encrypted key)

out_trade_no
string

Merchant order number. Required when trade_no is not provided.

trade_no
string

Platform order ID. Required when out_trade_no is not provided.

Response

200 - application/json

Epay-compatible operation result

code
enum<integer>
Available options:
1
msg
string
trade_no
string
out_trade_no
string
type
enum<string>

Payment channel type in Epay compatibility mode.

Available options:
alipay,
wxpay,
creditcard,
crypto,
paynow
pid
string
addtime
string

UTC datetime string, format yyyy-MM-dd HH:mm:ss

endtime
string

UTC datetime string, empty when unpaid

name
string
money
string
status
enum<integer>

1 means paid/settled; 0 means not paid

Available options:
0,
1
param
string
buyer
string

Reserved field, currently empty string