甬易支付文档中心

主题

Native支付下单 ​

接口描述 ​

  • 商户系统先调用该接口在甬易支付服务后台生成预支付交易单，返回正确的预支付交易会话标识后再按Native、JSAPI、App等不同场景生成交易串调起支付。

请求URL ​

  • /trade/nativePay

请求方式 ​

  • POST

公共请求参数 ​

参数名必选类型最大长度说明示例
appId是stringappId202409561403450909
signature是string签名
transNonce是string32请求流水号123456
transDate是string13请求时间，13位时间戳1731406784607

请求参数 ​

参数名必选类型最大长度说明示例
merchantNo是string32商户编号XS240820000054
outTradeNo是string32接入方交易流水号OUT00000001
tradeAmount是string20交易金额(单位分)100
tradeSubject是string255交易标题苹果手机
subsidyAmount否string20补贴金额(单位分)100
tradeCategory否string20交易类别 NORMAL:普通交易(默认值),ENSURE:担保交易NORMAL
expiryTime否string订单超时时间(单位分钟，取值范围【15～1080】)；默认30分钟30
notifyUrl否string255通知回调地址https://aaa.bbb.com/trade/notify
payBrand是string支付品牌：
YOYIPAY-甬易支付，ALIPAY-支付宝，UNIONPAY-银联二维码		YOYIPAY
limitPayWay否string限制支付方式：
BANLANCE-限制余额不能交易，BANKCARD_DC-限制借记卡不能交易，BANKCARD_CC-限制贷记卡不能交易		BANLANCE
payerIp否string32付款方ip
longitude否string32经度123.12
latitude否string32维度666.12
psType否string分账类型,默认不分账：担保交易不填写分账信息
Y-分账，N-不分账；		N
psDetail否string分账详情(json字符串)[{"inMerchantNo":"XS240820000050","amount":50},{"inMerchantNo":"XS240820000051","amount":50}]
- amount否number20分账子订单金额(单位分)，psType为Y是必填50
- inMerchantNo否string32入账商户号，psType为Y是必填XS240820000050

请求报文示例 ​

json
 {
  "appId": "202415629590370906",
  "merchantNo": "XS241026000093",
  "openId": "yoyipay1jcd7fu45tk01",
  "outTradeNo": "18511110003547765",
  "payBrand": "YOYIPAY",
  "psType": "Y",
  "psDetail":"[{\"inMerchantNo\":\"XS240820000050\",\"amount\":50},{\"inMerchantNo\":\"XS240820000051\",\"amount\":50}]",
  "signature": "pz+Z8unqO2VBjTGtzWASCCfzix5QxODSkAdKKyPiVXIXLtp574xCmuWaOeHfslnbUK2RKsYdNy/OhcMPV+GMaoXxcXuDvmVhUdKHWgYODovK5GbbqfqaT+nrzO0xnNz8rLCnevTQ3y4+Qn6++xVlwyMOW3SDw9gRM5qF40TlectpvylieoFROXzYIHXBveRrcT3FQSwnoNamNet/k7OTvotiT0Fft6SGDflqkWeHhiP83265OSMvQPwtIcEStyTv4AHLsWC5pSd7zTQ+pkvetMlm0AAwO6Jl4xUYx+OZkBM8vpgxqAQa4yzV9mTwfsaFZsKRnTXTJdFVHr9xONro5g==",
  "tradeAmount": "1",
  "tradeSubject": "苹果手机",
  "transDate": "1731469621597",
  "transNonce": "43e2c287-24b1-4cd1-b3d2-e40e7840cc40"
}

公共响应参数 ​

参数名必选类型最大长度说明示例
code是string响应编码00000000
message是string响应信息成功
signature是string签名
transNonce是string32请求流水号(同入参)123456
transDate是string13请求时间，13位时间戳1731406784607

响应参数 ​

参数名必选类型最大长度说明示例
tradeNo是string32支付系统交易流水号1854100814175592449
qrCodeUrl是string二维码链接

响应示例 ​

json
 {
  "code": "00000000",
  "message": "成功",
  "tradeNo": "1856544267009564674",
  "qrCodeUrl": "https://aaa.bbb.ccc/asdfqwdasd",
  "transDate": "1731469621597",
  "transNonce": "43e2c287-24b1-4cd1-b3d2-e40e7840cc40",
  "signature": "pz+Z8unqO2VBjTGtzWASCCfzix5QxODSkAdKKyPiVXIXLtp574xCmuWaOeHfslnbUK2RKsYdNy/OhcMPV+GMaoXxcXuDvmVhUdKHWgYODovK5GbbqfqaT+nrzO0xnNz8rLCnevTQ3y4+Qn6++xVlwyMOW3SDw9gRM5qF40TlectpvylieoFROXzYIHXBveRrcT3FQSwnoNamNet/k7OTvotiT0Fft6SGDflqkWeHhiP83265OSMvQPwtIcEStyTv4AHLsWC5pSd7zTQ+pkvetMlm0AAwO6Jl4xUYx+OZkBM8vpgxqAQa4yzV9mTwfsaFZsKRnTXTJdFVHr9xONro5g=="
}

备注 ​