Skip to main content
POST
submit.php (redirect checkout compatibility endpoint)

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
userId
string

Optional merchant user identifier passed to the payment gateway when supported.

device
enum<string>

Optional device hint. For Alipay/WeChat, reusing the same out_trade_no with a different device flow can be rejected.

Available options:
pc,
mobile
channel_param
string

Optional JSON string for channel-specific fields.

Response

Request rejected (returns compatibility error body)

code
enum<integer>
Available options:
0
msg
string