Cloudtay
Taypay Epay

创建订单接口

Taypay 创建订单接口说明与示例。

创建订单接口

POST /api/payment/open/epay/mapi
Content-Type: application/x-www-form-urlencoded

鉴权参数:

  • 必填: pid, sign
  • 可选: sign_type (缺省或空值按 MD5, md5MD5 均可)
  • MD5sign_type 会返回不支持错误
  • submit 接口与本接口使用相同鉴权规则

请求参数

字段类型必填说明
pidstring商户应用 ID。
typestring支付通道, 如 alipay / wxpay
out_trade_nostring商户订单号, 需全局唯一。
notify_urlstring支付结果通知地址。
return_urlstring页面支付完成后的返回地址。
namestring订单标题。
moneystring订单金额, 单位元。
clientipstring客户端 IP。
devicestring支付终端信息, 支持 pc / desktop / webmobile / wap / h5 / android / ios 等。
sign_typestring签名算法, 缺省按 MD5
signstring签名值。

请求示例:

pid=your_app_id
type=alipay
out_trade_no=M202605220001
notify_url=https://merchant.example.com/payment/notify
return_url=https://merchant.example.com/payment/return
name=VIP会员月卡
money=99.00
clientip=127.0.0.1
device=pc
sign_type=MD5
sign=generate_by_epay_md5_rule

终端识别规则:

  • device 优先级高于请求 User-Agent
  • device 为空时, 平台会根据 User-Agent 识别 PC 或移动端。
  • 两者都无法识别时, 使用 core_payment.epay.channels.{type}.default 配置的默认通道。

响应参数

字段类型说明
codeinteger接口响应码, 1 表示成功。
msgstring响应说明。
O_idstring平台订单号。
trade_nostring商户订单号。
payurlstring收银台跳转地址。
qrcodestring支付二维码内容。
imgstring二维码图片地址。

响应示例:

{
  "code": 1,
  "msg": "success",
  "O_id": "EP202605220001",
  "trade_no": "M202605220001",
  "payurl": "https://pay.example.com/checkout/EP202605220001",
  "qrcode": "",
  "img": ""
}
Copyright © 2026