跳转至

余额支付收单接口

请求方式 body 编码 接口地址
POST application/json UTF-8 集测:https://mchapitest.shengpay.com/balancepay/pay
生产:https://mchapi.shengpay.com/balancepay/pay

请求参数

变量名 类型 必填 示例值 描述
mchId String(16) Y 93751497 商户号
outTradeNo String(64) Y 1602835300345 商户订单号
tradeType String(32) Y balance_pay 支付渠道,固定值:balance_pay
notifyUrl String(128) Y http://10.241.80.32:8082/payNotify 商户通知回调地址
totalFee long Y 付款金额(单位分)
currency String(8) Y CNY 标准币种
marketingCampaign JSONObjectString(1024) N {} 营销活动
payeeMchId String(32) Y 703424 收款方
currency String(8) Y CNY 标准币种
isNeedShare String(8) N FALSE 是否需要分账,如果需要分账,请先开通分账合同
TRUE-是,需要分账
FALSE-否,不分账
body String(64) Y 商品描述
attach String(1024) N 附加信息(可自定义备注,要求JSON字符串)
nonceStr String(32) Y JtxlJ6aV06gaPbOojRuiN4L3vmqOs9dB 随机字符串
signType String(8) Y RSA 签名类型
sign String (1024) Y 签名 (见签名介绍)

请求示例

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
{
    "attach":"{\"latitude\":\"纬度\",\"bi\":\"基站信息\",\"longitude\":\"经度\"}",
    "authCode": "134528746265137121",
    "body": "聚合支付",    
    "currency": "CNY",
    "isNeedShare": "false",
    "mchId": "93751497",
    "nonceStr": "pFUuICf7GFHUGaAkiaWE5ZZNVRQzvNFy",
    "notifyUrl": "http://10.241.80.32:8082/payNotify",
    "outTradeNo": "1602833989984",
    "marketingCampaign": "{}",
    "payeeMchId": "93751497",
    "sign": "cICZ8/00NUVTv0qp6zz/MxXp/3YNuHYWN3+/kTr1QSQJS6UtUKxDWLQ4jm6h7G3vyPdHZdLJeyGxmaAo6n7Vb7Bqai9BOSDPwdzW2NmsMp/W38g/DW50Y6BYJrSnn8nFw2cqoJB8/pMVGoyIx4pmwKY7y3PBBAUyYe0FTYRhDjuoJ7xENeaCdkob3Cv9aQAvxPcdn2JNJa9xcpXpk7/xNmNTTNcpIUxBk+pPNvqDSVHh8QRYYz7asbyo69qOqHtHD+GyDFduGC9nJaSkMu930clNFxkjnTLTVtryvc/aB2SKsoiAvqxGwXFQF4T5/VK4Nf1Kykxz0pcBSkPQh5e9EQ==",
    "signType": "RSA",    
    "totalFee": 10,
    "merchantFee": 1,
    "tradeType": ""
}

响应参数

变量名 类型 必填 示例值 描述
returnCode String Y SUCCESS 返回码(SUCCESS/FAIL)
returnMsg String N 返回消息(当returnCode为FAIL时使用)
resultCode String Y SUCCESS 业务结果(SUCCESS/FAIL)
errorCode String N 错误代码(当resultCode为FAIL时使用) 枚举类:(见错误码枚举类)
errorCodeDes String N 错误描述(当resultCode为FAIL时使用)
mchId String Y 商户号
payeeMchId String N 收款方商户号
outTradeNo String Y 商户订单号
transactionId String Y 盛付通订单号
totalFee int Y 付款金额(单位分)
paidAmount int Y 支付金额(单位分)
merchantFee long Y 手续费(单位分)
marketingCampaign JSONObjectString(1024) N {} 营销活动
payeeMchId String(32) Y 703424 收款方
status String Y 订单状态(见订单状态说明)
payTime String N 20201016160142 支付时间(格式为yyyyMMddHHmmss)
attach String N 附加信息(JSON字符串)
nonceStr String Y 随机字符串
signType String Y RSA 签名方式
sign String Y 签名 (见签名介绍)

响应示例

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
{
    "mchId": "93751497",
    "payTime": "20201016160142",
    "resultCode": "SUCCESS",
    "sign": "D93b54cbND5p7WVf2dPsGve0vmTAI7RI4uSRYbCQtYnaHDI3xhawyar2ri+mg/RrOaZOxa1dz+B2i0kchRsHk6miO2AbyY9Xoo94SPoCKGe4XZOUZngQWyisYf3kG2rvsBE/PgxyOe9eU0/2zujDiNvF3u4ltgJ32CE7u0UMeVY=",
    "transactionId": "M20201016348523693586173952",
    "nonceStr": "OlnsDwQpogsfDdMYfZnzkYpMiKdiAGoU",
    "returnCode": "SUCCESS",
    "totalFee": 10,
    "outTradeNo": "1602835300345",
    "signType": "RSA",
    "attach": "",
    "paidAmount": 0,
    "status": "PAY_ING"
}
Back to top