submit.php (redirect checkout compatibility endpoint)

curl --request POST \ --url https://api.kyren.top/epay/submit.php \ --header 'Content-Type: application/x-www-form-urlencoded' \ --data pid=merch_001 \ --data type=alipay \ --data out_trade_no=order_20260409001 \ --data notify_url=https://merchant.example.com/pay/notify \ --data return_url=https://merchant.example.com/pay/return \ --data 'name=Pro Plan Subscription' \ --data money=99.00 \ --data money_type=CNY \ --data 'display_merchant_name=Campaign Store' \ --data param=user_42 \ --data sign=fb7f5f742f89eb1f137fbc293f2bf42a \ --data sign_type=MD5

Body

application/x-www-form-urlencoded

pid

string

required

Merchant ID

type

enum<string>

required

Payment channel type in Epay compatibility mode.

Available options:

alipay,

wxpay,

creditcard,

crypto,

paynow

out_trade_no

string

required

Merchant order number (must be unique under one merchant)

notify_url

string<uri>

required

Merchant async callback URL

return_url

string<uri>

required

Merchant sync return URL

name

string

required

Product name

money

string

required

Order amount, decimal string, must be greater than 0

sign

string

required

Lowercase MD5 signature

sign_type

enum<string>

required

Signature type. Current compatibility implementation only supports MD5.

Available options:

MD5

money_type

string

default:CNY

Currency code. Defaults to CNY when omitted.

param

string

Pass-through parameter returned in callbacks and order queries

display_merchant_name

string

Optional per-payment merchant display name shown on Kyren intermediate payment pages

Maximum string length: 80

Response

Request rejected (returns compatibility error body)

code

enum<integer>

Available options:

0

msg

string