文档
测试
POST
http://crm.houcaller.com/ysPayController/ysPay

请求头

参数名
类型
描述
必填
strParams
String
加密后的参数 参考加密方法 参考请求DEMO
必填

请求参数

text/plain
参数名
类型
描述
必填
posId
String
对应支付参数ID
必填
merOrderId
String
商户订单号
必填
goods
商品对象
商品信息
可选
attachedData
String
商户回调渠道(必填!需要在支付通道配置好对应渠道的回调地址)
必填
expireTime
String
订单过期时间 为空则使用系统默认过期时间(30分钟),格式yyyy-MM-dd HH:mm:ss
可选
orderDesc
String
账单描述
可选
totalAmount
BigDecimal
支付总金额
必填
divisionFlag
boolean
分账标记 若为true,则goods字段和subOrders字段不能同时为空
可选
platformAmount
BigDecimal
平台商户分账金额 若分账标记传,则分账金额必传
可选
subOpenId
String
用户OPENID 微信必传,需要商户自行调用微信平台接口获取,具体获取方式请根据微信接口文档
必填
userId
String
用户子标识 ,需要商户自行调用支付宝接口获取,具体获取方式请根据支付宝接口文
可选
subOrders
List
子订单信息 在传分账标记的情况下,若传子商户号,子商户分账金额必传,不超过20个,分账方案subOrders里子商户分账总额+platformAmount要与支付总额totalAmount相等
可选
posId
String
机构号
必填
merOrderId
String
商户子订单号
可选
totalAmount
BigDecimal
子商户分账金额
必填
subAppId
String
微信子商户APPID
必填

请求示例

加密前: { "asynDivisionFlag":false, "attachedData":"ZXN-STCARD", "divisionFlag":true, "limitCreditCard":false, "merOrderId":"EU2210251509251HFV1RXZ", "platformAmount":0, "posId":"HKL0005", "subOpenId":"oDiYh5QjaeEUhlOG6EAYFq1VcLuw", "subOrders":[ { "posId":"HKL0002", "totalAmount":80000 } ], "totalAmount":80000 } 加密后: 99B207808AAAB61B46096281436185C0AD922989D64774FDCFA2EDF05A3BCA20A3D7C4D3BC013E2BCECF9A695C7DDF9A65157C83F9FE39593085DB00DDB004BF17001B9A508A888056A37C8B134A46F07E4577B109E8F0E44CFEECE771037E9DA1E9C5BD8CD7AE3DA82C4844400441146684DF4A3EA5D058C2A5B0382F7CA0CB6995570B423E6B391756B85DC6D90A82BF888DF65B5149EE481646F9B8E4FFF44CC3EBCDAF64A8F7BCAE430F6FF7EA98A7B87B6B49A8E1510BAFAAC071CE30750748AE49BFBE0DFC88DCD6B8FC60689B9912F5EE7A7634E57EDB7DB0C3B7632719911F732F7D88F1B3C063D556E92B5FCBB8FF9EC8011B2352938BABFC6DD84B4EC283F5E5ECA29AB9D3C847C3A272088D830451F737FE105D25784D037687EC0DA1077485A7D34F23AE13A66CB55B94B5FD103A1068814D5AC232E7F17CA73AFDED54D642342410DE0B1307093CCA40B0583ABF22D9A2C269450C2F8AB54F6FC25E7C11E5D957FF7DFA3166490F1DF3C232BE9B176067F90B4E7E5419C0F189

响应参数

参数名
类型
描述
必填
result
int
响应状态 1:成功 0:失败 2:银商系统错误
必填
msg
String
响应数据
必填
data
String
响应内容
必填

响应数据

参数名
类型
注释
描述
connectSys
string
链接系统
示例:UNIONPAY
delegatedFlag
string
标识
示例:N
merName
string
商户名称
示例:厦门宅小牛科技服务有限公司
mid
string
商户号
示例:89835065812APRE
settleRefId
string
清分ID
示例:29705530000N
tid
string
终端号
示例:UEN7NT67
totalAmount
int
总金额
示例:50000
targetMid
string
支付渠道商户号
示例:527237510
responseTimestamp
string
请求时间
示例:2022-09-19 21:00:30
errCode
string
平台错误码
示例:SUCCESS
miniPayRequest
object
小程序支付用的请求报文,带有签名信息
timeStamp
string
示例:1663592430
package
string
示例:prepay_id=wx19210030551126375646ee3095feae0000
paySign
string
示例:WezXkFTEe03IrOaG7wouMzHIk2YQKMkwzoIl39FkfPFUI0iLDISf0an8+ZZo2MQ+NEv17lVkTsP3aayEmPNYe/FKvXYlHIX3fgXVAKZELcSaSVcQR6ek8soKsrtvDtDx+1aXNy8rbcqJSEwgz8Z3ahObtfHSShChYdRrCwQlENbQ2FTFlRQThJVNkU0VQjkLFbst26eaSR6O7WLQ6fij4sWpdPe0/jfdT+L04rIJlkzfOSdV64e6p+JSkCNPe0q1qb1IjFH1Awz4JAqa6s9QH1i1S3vFKNO+WwgCecAlhEbTyvR4n7Vb7QsIdeo3SgVvJNeGwov2l3xxDZRXmm5iUA==
appId
string
示例:wx1e342103439de630
signType
string
示例:RSA
nonceStr
string
示例:7472508cded2436f9470fbb6efea6c67
targetStatus
string
目标平台的状态
示例:SUCCESS|SUCCESS
seqId
string
平台流水号
示例:29705530000N
merOrderId
string
商户订单号
示例:146AEU220919210029F0RNKJFP
status
string
交易状态
示例:WAIT_BUYER_PAY 参考平台状态码
targetSys
string
目标平台代码
示例:WXPay

平台状态码

参数名
描述
NEW_ORDER
新订单
UNKNOWN
不明确的交易状态
TRADE_CLOSED
在指定时间段内未支付时关闭的交易;在交易完成全额退款成功时关闭的交易;支付失败的交易。 TRADE_CLOSED的交易不允许进行任何操作。
WAIT_BUYER_PAY
交易创建,等待买家付款。
TRADE_SUCCESS
支付成功
TRADE_REFUND
订单转入退货流程

返回示例

{ "connectSys":"UNIONPAY", "delegatedFlag":"N", "merName":"厦门宅小牛科技服务有限公司", "mid":"89835065812APRE", "settleRefId":"29704170485N", "tid":"UEN7NT67", "totalAmount":50000, "targetMid":"527237510", "responseTimestamp":"2022-09-19 20:23:46", "errCode":"SUCCESS", "miniPayRequest":{ "timeStamp":"1663590226", "package":"prepay_id=wx19202346530320cb050dc873a5b7e10000", "paySign":"BfrpK4sTjHqdwZxjX7YDq3jyFOcPJZu3rRmzzQHxccZSmaLMqpTXX3uLuH06I1JImONlEHFckSdBGb1MWAaFjb3Jjsjr5hKTbOxWtU8xoljF3184IKVE9EWvy0Evycx7LBvov8c9N3ZCB+3ferdz2sPGFxDaH+SobZpAxxUM7/Lp1LB1kX+VSAO3SJ/xxhWlg/0i0NUKr7OZKmltcymVxwzeoBtd5CkND2+oV1EZFQ/CI4gRSr4iPwoZFonQqhl7rCJdIVBBQeXOQrpzK6m3kFtCSh1ur8Nc/KSNZUqLR3zS6ry20odtxknS9WAjjwjsJUiJfd5U86pVLWbpI5tWEQ==", "appId":"wx1e342103439de630", "signType":"RSA", "nonceStr":"39f7b968439c4d088ec64fd369b61751" }, "targetStatus":"SUCCESS|SUCCESS", "seqId":"29704170485N", "merOrderId":"146AEU220919202345GAZR0IQO", "status":"WAIT_BUYER_PAY", "targetSys":"WXPay" }

平台错误码

参数名
描述
原因和应对措施
SUCCESS
成功
INTERNAL_ERROR
内部错误
系统错误,请联系技术支持。
BAD_REQUEST
请求报文有错
报文格式有错误,请对照文档检查报文格式。
NO_SERVICE
没有能处理请求msgtype的服务
msgType错误,请检查文档,msgType是否拼写正确。
TIMEOUT
处理超时
处理超时,很可能是微信和支付宝的网络请求没应答,建议重试或者撤销交易。
NO_ORDER
找不到请求的原始订单
对应的mid+merOrderId不正确,无法找到原交易,请检查merOrderId是否跟原交易一致。
OPERATION_NOT_ALLOWED
当前不允许此操作
订单已经关闭,不能执行退货等操作。
TARGET_FAIL
支付宝方支付失败,如请求没有成功,或者请求成功,但是没有正确处理。
支付宝或者微信方业务失败,请根据返回信息确定具体原因。
DUP_ORDER
重复的订单请求
支付请求的merOrderId重复,请检查终端是否做过复位操作,导致流水号等重复。
NET_ERROR
跟支付包通讯出问题,包括 请求发送异常,报文应答不 是200,请求被取消,应答 超时等。
通讯问题,联系运行检查网络情况。
NO_MERCHANT
找不到请求指定的商户
请求报文的mid在网付前置无法找到相关的配置,请确认终端的商户号是否正确在网付前置配置,是否经过转商户处理。
ORDER_PROCESSING
订单正在处理中,不允许并发操作。
当前订单的上一次操作没有完成,订单处于锁定状态,请等待一分钟后再试。
INACTIVE_MERCHANT
商户被置为inactive状态
交易商户在网付前置被冻结。
ABNORMAL_REQUEST_TIME
请求时间异常
请求终端或者平台的系统时间不正常,请检查系统时间。
TXN_DISCARDED
请求开始处理时间延迟过大,交易被丢弃。
系统负载过大,交易被丢弃,请联系运行。
BAD_SIGN
签名错误
报文签名错误,请联系技术指导签名算法。
INVALID_MSGSRC
商户来源错误
系统配置有问题,请联系技术。
INVALID_ORDER
订单信息异常
该订单支付时有异常,缺少关键数据,请先做一笔订单查询,补充关键数据后再次进行退货等操作。
NO_CROSS_DAY_TRADING
不允许跨日交易
可能某些渠道不支持跨日撤销,建议做退货。
DENIED_IP
不允许此IP交易
IP不在白名单中,请联系管理员确认
INVLID_MERCHANT_CONFIG
错误的商户配置
商户配置参数有问题,请联系业务人员检查商户配置参数。
INVALID_RESPONSE
无效的应答报文
支付渠道方的应答报文有问题,比如验签失败、报文格式错误等。