4.1.1 统一下单接口

联调环境

https://api.qywh8.com

POST

/openapi/pay/create

间联无法使用原生APP与H5支付说明

由于微信官方与支付宝官方未对间联机构（指除微信与支付宝外的持牌收单机构）开放原生APP与H5支付能力，故使用间联机构支付能力的商户无法使用原生APP与H5支付，可自行包装APP或者H5跳转小程序进行支付方案进行

警告

目前微信支付任何场景跳转到小程序进行支付的能力目前微信严控状态，不建议使用跳转小程序支付功能，如果必须使用且场景正规可使用线上费率，申请微信原生APP支付，H5端暂无法解决，目前我司对于间联微信H5与APP支付有权限限制，非特批商户无法调用，可联系客户经理咨询

1，该接口支持正扫，反扫，jsapi，app，h5支付
2，间联支付宝app可调用扫码支付，返回的支付链接可使用alipays://方法调起支付宝客户端，如果需要支付成功后返回app 需要使用支付宝小程序支付，可联系商务进行报备配置
3，间联微信app支付可自行封装小程序然后调用小程序支付进行，也可使用我司或机构小程序进行支付，可联系商务进行报备配置
4，目前间联已支持微信与支付宝原生APP支付与H5支付，需要单独报备，可联系商务进行报备
5，如果是系统自动轮训未传入mchChannelCode子通道code并且为非同机构多通道轮训不建议使用分账，如果使用分账必须是同一机构同一个服务商下的通道才能共用分账接收方（部分渠道可能也不支持此种方式需要单独报备）
6，调用微信H5支付非原生支付时，返回的payDataType支付数据格式类型为：data，payInfo跳转支付数据中新增schemeCode参数为H5跳转到小程序链接（版本号（version）请传1.01，传了才会生效）
7，调用微信APP支付非原生支付时，返回的payDataType支付数据格式类型为：data，payInfo跳转支付数据中新增userName参数为小程序原始id，path为拉起小程序页面，返回已拼接参数，您也可自行拼接参数，格式为：pages/lump-sum/lump-sum?payOrderNo=123 其中payOrderNo为平台订单号（版本号（version）请传1.01，传了才会生效）
8，使用微信APP支付非原生支付跳转到小程序完成支付后，如需回跳到支付APP可参考微信开放平台（版本号（version）请传1.01，传了才会生效）https://developers.weixin.qq.com/doc/oplatform/Mobile_App/Launching_a_Mini_Program/Android_Development_example.html 进行调用微信官方SDK
9，调用云闪付APP时，使用返回字符串中的tn（银联受理订单号）放入银联官方的SDK中拉起原生app支付。详见：https://open.unionpay.com/tjweb/acproduct/list?apiSvcId=3021&index=4
10，调用银盈通支付宝H5和APP支付时，返回的为渠道侧拼接的链接，请将返回的url进行encodeURIComponent转义后拼接，如："alipays://platformapi/startApp?appId=20000067&url="+ encodeURIComponent(url);

根据场景客户端调用相关支付方式说明（只适合微信）

1. APP客户端：paySubType 支付方式可选择APP
2. H5客户端（微信内）paySubType 支付方式可选择NATIVE
3. H5客户端（微信外）paySubType 支付方式可选择H5
4. PC客户端 paySubType 支付方式可选择NATIVE
5. 小程序客户端 paySubType 支付方式可选择MINI_APP

直付通调用说明

1. APP客户端：paySubType 支付方式可选择APP
2. H5客户端 paySubType 支付方式可选择H5
4. PC客户端 paySubType 支付方式可选择PC

请求参数

Body 参数application/json

appId

string

应用APPID

必需

商户应用APPID

subSn

string | null

子商户编码

可选

非必传项，目前仅代理商/服务商可传，普通商户和平台商户请勿传入

timestamp

string

时间戳

必需

请求时间戳单位秒，要求timestamp与当前时间间隔在60秒以内

requestId

string

请求id

必需

请求唯一标识，无其他意义，必须每一次请求不允许重复，用于定位问题，长度应大于24个字符小于64个字符

version

string

版本号1.01

可选

默认空，2025年2月20日之后接入的可传，最新版本为1.01，可传1.01

signType

string

签名方式

必需

固定值：RSA2

bizContent

object

请求参数

必需

由于工具限制，该字段必须转为JSON 格式字符串，请务必注意

payType

string

支付类型

必需

WECHAT: 微信 ALIPAY: 支付宝 UNION_PAY: 云闪付 DIGITAL: 数字人民币 QUICK：快捷支付 ONLINE：网银支付

paySubType

string

支付方式

必需

NATIVE :扫码支付； SCAN : 反扫支付； JSAPI :微信JSAPI、支付宝JSAPI支付、银联JSAPI支付； SIMPLE :简易支付； MINI_APP :微信小程序支付、支付宝小程序支付； H5 :h5 支付； APP :APP 支付； PC :支付宝PC支付

sceneType

string

场景类型

可选

1 线下 2 线上不传默认线下

providerCode

string

服务商编码

可选

不传随机路由

channelCode

string

渠道编码

可选

不传随机路由

mchChannelCode

string

通道编码

可选

不传随机路由，SAAS平台商调用必传该参数否则会出现资金问题，获取路径---应用通道---应用通道---通道编号中19开头即是

channelReportCode

string

支付宝微信报备code

可选

不传随机路由

mchOrderNo

string

商户订单号

必需

规则英文字符,数字,_ 长度应大于24个字符小于64个字符

>= 24 字符<= 64 字符

amount

string

订单金额

必需

单位元

clientIp

string

买家ip

必需

目前仅支持ipv4，必须传入真实买家客户端IP，该参数将上传至机构，所以一定要注意机构会做风险鉴权和大数据拦截，非跨境电商类商户禁止传国外ip（特殊情况需要提前报备），否则系统监测到将会拉黑商户与进件主体

subject

string

商品标题

必需

不能超过64个字符

description

string

商品描述

可选

extra

object | null

通道额外参数

可选

notifyUrl

string

异步通知

可选

支付结果异步通知地址，禁止携带 ?& 等参数

redirectUrl

string

同步跳转地址

可选

同步跳转地址，不会携带任何参数

expiredTime

integer

订单过期时间

可选

不传默认30分钟单位秒

默认值:

360

示例值:

360

fundProcessType

string

分账类型

可选

0或空=无分账，1=实时分账，2=延时分账，3=商户预设默认分账

默认值:

null

示例值:

null

acctInfos

array[object (分账数据) {5}] | null

分账接收方列表

可选

非空或0必传

marketingOrders

array [object {7}]

营销信息

可选

营销信息

sign

string

签名

必需

参照签名方法

示例

{
    "appId": "APP_8428691003",
    "timestamp": "1738723467",
    "requestId": "003320f87eb83b826bff448501e4859a",
    "signType": "RSA2",
    "bizContent": "{\"payType\":\"WECHAT\",\"paySubType\":\"APP\",\"mchOrderNo\":\"1b7361b6112df11211df3af\",\"amount\":\"0.1\",\"clientIp\":\"201.152.70.151\",\"subject\":\"山竹\",\"description\":\"取款\",\"extra\":{\"originalType\":0,\"appName\":\"123\"}}",
    "sign": "cmPBd18V41zrfPoCCpbZsjCezspyQdmMiySwowg8wpah4A8ra/FGfUInSfe0Fksn5t9Yg2ePzJzAIsrsJM0ydGR9YysPqL3sNRU3IPhOKZ6SBIps78YFsKOFAPDb6I00wr0butBY0VGHmtaSxRm+oS5u1UMy8nJloBCv6FfZHO8FASBptK7z/f1qTzI6UroDsfcybp6cIgwDipdL/khDcJDt3GQYwj5v+MIldJKZNGHxXfcgntv9OiqlbNuD7vORKPKyPoTxDr6JsLmZwb2I7z5ePPJBQs1NcFEh+pxbTpggKtlE1v4KnPZdYUA+Bq6Hoa+AliXOz8C/2RtyGgvH3g=="
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://api.qywh8.com/openapi/pay/create' \
--header 'Content-Type: application/json' \
--data-raw '{
    "appId": "APP_8428691003",
    "timestamp": "1738723467",
    "requestId": "003320f87eb83b826bff448501e4859a",
    "signType": "RSA2",
    "bizContent": "{\"payType\":\"WECHAT\",\"paySubType\":\"APP\",\"mchOrderNo\":\"1b7361b6112df11211df3af\",\"amount\":\"0.1\",\"clientIp\":\"201.152.70.151\",\"subject\":\"山竹\",\"description\":\"取款\",\"extra\":{\"originalType\":0,\"appName\":\"123\"}}",
    "sign": "cmPBd18V41zrfPoCCpbZsjCezspyQdmMiySwowg8wpah4A8ra/FGfUInSfe0Fksn5t9Yg2ePzJzAIsrsJM0ydGR9YysPqL3sNRU3IPhOKZ6SBIps78YFsKOFAPDb6I00wr0butBY0VGHmtaSxRm+oS5u1UMy8nJloBCv6FfZHO8FASBptK7z/f1qTzI6UroDsfcybp6cIgwDipdL/khDcJDt3GQYwj5v+MIldJKZNGHxXfcgntv9OiqlbNuD7vORKPKyPoTxDr6JsLmZwb2I7z5ePPJBQs1NcFEh+pxbTpggKtlE1v4KnPZdYUA+Bq6Hoa+AliXOz8C/2RtyGgvH3g=="
}'

返回响应

🟢200OK

application/json

Body

code

integer

请求状态

必需

返回200=成功，其他状态均为失败

data

object

返回数据体

可选

mchOrderNo

string

商户订单号

必需

payOrderNo

string

平台订单号

必需

channelOrderNo

string

渠道订单号

可选

第三方渠道订单号

instOrderNo

string

支付机构订单号

可选

微信支付宝等平台订单号

payDataType

string

支付数据类型

可选

pay_url-支付链接，data-数据体，form-表单格式，none-空支付参数

payInfo

string

跳转支付数据

可选

state

string

订单状态

必需

订单状态，订单状态，1=初始化，2=支付中，3=支付成功，4=已撤销，5=订单关闭 6=订单关闭中 7=支付失败

amount

string

订单金额

必需

单位元

payAmount

string

实际支付金额

可选

单位元

payType

string

支付类型

必需

WECHAT: 微信 ALIPAY: 支付宝 UNION_PAY: 云闪付 DIGITAL: 数字人民币

paySubType

string

支付方式

必需

sceneType

integer

场景类型

可选

1 线下 2 线上不传默认线下

providerCode

string

服务商编码

可选

channelCode

string

通道编码

可选

subChannelId

string

子通道id

可选

feeAmount

string

平台扣手续费

可选

feeRate

string

平台扣手续费率

可选

channelFeeAmount

string

通道扣手续费

可选

channelFeeRate

string

通道扣手续费率

可选

settlementAmount

string

实际记账金额

可选

即 amount-feeAmount-channelFeeAmount

subject

string

商品标题

可选

description

string

商品描述

可选

successTime

integer

支付成功时间

可选

单位毫秒

msg

string

返回信息

必需

appId

string

应用APPID

可选

string

商户编码

可选

sign

string

签名

可选

timestamp

string

时间戳

可选

signType

string

签名方式目前仅支持RSA2

可选

示例

成功示例微信js返回示例支付宝js返回数据示例微信非原生APP与H5支付

{"code":200,"data":{"mchOrderNo":"1b7361b62df24df2b3af","payOrderNo":"D20250106160835142332928","channelOrderNo":null,"insOrderNo":null,"payDataType":"url","payInfo":"https://qr.alipay.com/bax03381qpf5ky9qj7uv556b","state":1,"amount":"0.1","payAmount":null,"payType":"ALIPAY","paySubType":"NATIVE","sceneType":1,"providerCode":"S1524906003","channelCode":"heepay","subChannelId":null,"subMchId":"250104173317088075","feeAmount":"0.00","feeRate":"0.0000","channelFeeAmount":null,"channelFeeRate":null,"settlementAmount":null,"subject":"山竹","description":"取款","successTime":null,"acctInfos":null},"msg":"成功","appId":"APP_8428691003","sn":"M428683001","sign":"L1wgZzrdu88xgPANTNMS0ruuJ+wKCxUo1M+yFLCWb3xmqtE6CzSJveOQtt+oEbjPZ1H6lOYeYuZxy+Ubs7Ki8jyFG9GQPU0ekP7bL8+jMTnUmAqsWq1rqv9CSRVWP2piPBnboJRdmg6PsuYT8Av7v7sTuvwQkQeR+vFmhAWxheILpFvjyyUf2B0t6qKrzHV1l7dVoCyD0utpIZ01bA3GWyMafTYHsQEDLMkF0hONuuoPxPiL//zPyLFb76M1ZYRqtqtRTg9LAG5n13epyPBbC3D57g4f0LBV6+7ypIVkfJfPDkAURJkT0flTiRy99IloLvg/qc1wn7ce9len8umA8Q==","timestamp":"1736150915","signType":"RSA2"}

4.统一交易类接口

4.1.2 交易查询

4.1.1 统一下单接口

根据场景客户端调用相关支付方式说明（只适合微信）#

直付通调用说明#

请求参数

示例代码

返回响应

根据场景客户端调用相关支付方式说明（只适合微信）

直付通调用说明