甬易支付文档中心

主题

APP支付下单 ​

接口描述 ​

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

请求URL ​

  • /trade/appPay

请求方式 ​

  • 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
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",
  "outTradeNo": "18511110003547766",
  "psType": "Y",
  "psDetail":"[{\"inMerchantNo\":\"XS240820000050\",\"amount\":50},{\"inMerchantNo\":\"XS240820000051\",\"amount\":50}]",
  "signature": "s3D0VyqormaFFNGz3LNPDhCkUNRltCANrK7NrYnMbTNTV9bNnb80n2omn9rCknfDQeX/Q0HhsNNUgXDcbYTZVNzg2nOWcjfrvbT9lA1uW6kB1imh+eAct1ixXcBx9298DMS5lpVc90daS02qe8Xw5jrAdfshxC7L9clBdAiva4ZsV8KriSjnwv8llOCOM59ka+Kgj7Brb+mPtmyv/xrgPRjc6aY023w4fNo89I43Ltdpkxl3zvsYIGtDqZB5P47RxtmQgieNB1tFo3qwEL1Yqjlq+GE9LZdFf1UZFULJ/LdrowFfFx9S4xVQHtavCo93a5PmG0lf25OLJeYsTJ/Umg==",
  "tradeAmount": "1",
  "tradeSubject": "苹果手机",
  "transDate": "1731469661929",
  "transNonce": "7b817fc2-95b4-4b39-8eb7-518a849e1d15"
}

公共响应参数 ​

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

响应参数 ​

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

响应示例 ​

json
 {
  "code": "00000000",
  "message": "成功",
  "tradeNo": "1856544428586737666",
  "transDate": "1731469661929",
  "transNonce": "7b817fc2-95b4-4b39-8eb7-518a849e1d15",
  "signature": "s3D0VyqormaFFNGz3LNPDhCkUNRltCANrK7NrYnMbTNTV9bNnb80n2omn9rCknfDQeX/Q0HhsNNUgXDcbYTZVNzg2nOWcjfrvbT9lA1uW6kB1imh+eAct1ixXcBx9298DMS5lpVc90daS02qe8Xw5jrAdfshxC7L9clBdAiva4ZsV8KriSjnwv8llOCOM59ka+Kgj7Brb+mPtmyv/xrgPRjc6aY023w4fNo89I43Ltdpkxl3zvsYIGtDqZB5P47RxtmQgieNB1tFo3qwEL1Yqjlq+GE9LZdFf1UZFULJ/LdrowFfFx9S4xVQHtavCo93a5PmG0lf25OLJeYsTJ/Umg=="
}

备注 ​