Taypay Epay
创建订单接口
Taypay 创建订单接口说明与示例。
创建订单接口
POST /api/payment/open/epay/mapi
Content-Type: application/x-www-form-urlencoded
鉴权参数:
- 必填:
pid,sign - 可选:
sign_type(缺省或空值按MD5,md5与MD5均可) - 非
MD5的sign_type会返回不支持错误 submit接口与本接口使用相同鉴权规则
请求参数
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
| pid | string | 是 | 商户应用 ID。 |
| type | string | 是 | 支付通道, 如 alipay / wxpay。 |
| out_trade_no | string | 是 | 商户订单号, 需全局唯一。 |
| notify_url | string | 否 | 支付结果通知地址。 |
| return_url | string | 否 | 页面支付完成后的返回地址。 |
| name | string | 否 | 订单标题。 |
| money | string | 是 | 订单金额, 单位元。 |
| clientip | string | 否 | 客户端 IP。 |
| device | string | 否 | 支付终端信息, 支持 pc / desktop / web 和 mobile / wap / h5 / android / ios 等。 |
| sign_type | string | 否 | 签名算法, 缺省按 MD5。 |
| sign | string | 是 | 签名值。 |
请求示例:
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配置的默认通道。
响应参数
| 字段 | 类型 | 说明 |
|---|---|---|
| code | integer | 接口响应码, 1 表示成功。 |
| msg | string | 响应说明。 |
| O_id | string | 平台订单号。 |
| trade_no | string | 商户订单号。 |
| payurl | string | 收银台跳转地址。 |
| qrcode | string | 支付二维码内容。 |
| img | string | 二维码图片地址。 |
响应示例:
{
"code": 1,
"msg": "success",
"O_id": "EP202605220001",
"trade_no": "M202605220001",
"payurl": "https://pay.example.com/checkout/EP202605220001",
"qrcode": "",
"img": ""
}
