回退分账
此接口对YabandPay分账成功的分账单进行回退
[!TIP|style:flat] 注意： 每个分账只能最多只能回退10次。
API URL：https://mapi.yabandpay.com/Payments
Method：POST
POST data type：Json
| 参数 | 类型 | 描述 | 是否必填 |
|---|---|---|---|
| user | String | 收银员账号的UID(需具有分账权限) | 必填 |
| sign | String | 签名 | 必填 |
| method | String | v3.SplitPayment | 必填 |
| time | Long | 时间戳 | 必填 |
- 参数
| 参数 | 类型 | 描述 | 是否必填 |
|---|---|---|---|
| commond | String | returnSplitPayment | 必填 |
| currency | String | 订单结算货币，Settlement Currency | 必填 |
| notify_url | String | 异步通知地址 | 必填 |
| nonce_string | String | 随机字符串，不长于32位 | 必填 |
| split_id | String | 创建分账后返回的分账订单id | 必填 |
| reference_id | String | 商户方的分账回退id，不长于32位，不能重复 | 必填 |
| reference | String | 描述信息，不长于128位 | 选填 |
| receivers | String | 分账接收方信息，json格式 | 必填 |
| receivers.mid | String | 分账接收方的mid | 必填 |
| receivers.split_detail_id | String | 创建分账后返回的分账明细id | 必填 |
| receivers.detail_reference_id | String | 分账接收方的分账回退明细单号 | 必填 |
| receivers.split_amount | String | 分账金额 | 必填 |
| receivers.description | String | 分账明细描述 | 必填 |
签名示例：
拼接为URL方式并排序后的字符串
"commond=returnSplitPayment¤cy=EUR&method=v3.SplitPayment&nonce_string=qxg9mzdxxh4pyi9fhb¬ify_url=https://www.yabandpay.com/notify&receivers=[{"mid":111,"split_amount":2,"split_detail_id":"20231229110618372777-1","detail_reference_id":"123456-1","description":"分账回退描述1"},{"mid":222,"split_amount":1,"split_detail_id":"20231229110618372777-2","detail_reference_id":"123456-1","description":"分账回退描述2"}]&reference=19398394598568&reference_id=123456&split_id=20231229110618372777&time=1703829894&trade_id=67943b0b-ca6b-aa96-5fb1-e354975f1ec4&user=9212776037"
得到的 stringA 使用 secret_key做签名
得到的签名如下：
"d9e94fe46ab35220316649d746d2cc99b7a5b5cbeeebf840cf192b1a39512604"
提交示例：
{
"user": "9212776037",
"sign": "d9e94fe46ab35220316649d746d2cc99b7a5b5cbeeebf840cf192b1a39512604",
"method": "v3.SplitPayment",
"time": 1703829894,
"data": {
"commond": "returnSplitPayment",
"trade_id": "67943b0b-ca6b-aa96-5fb1-e354975f1ec4",
"notify_url": "https://www.yabandpay.com/notify",
"reference_id": "123456",
"reference": "564635235",
"currency": "EUR",
"split_id": "20231229110618372777",
"nonce_string": "qxg9mzdxxh4pyi9fhb",
"receivers": "[{\"mid\":111,\"split_amount\":2,
\"split_detail_id\":\"20231229110618372777-1\",\"detail_reference_id\":\"123456-1\",\"description\":\"分账回退描述1\"},{\"mid\":222,\"split_amount\":1,
\"split_detail_id\":\"20231229110618372777-2\",\"detail_reference_id\":\"123456-1\",\"description\":\"分账回退描述2\"}]"
}
}
返回示例：
{
"status": true,
"code": "200",
"data": {
"user": "9212776037",
"split_id": "20231229110618372777",
"trade_id": "67943b0b-ca6b-aa96-5fb1-e354975f1ec4",
"state": "Success",
"merchant_mid": "123",
"merchant_name": "123",
"reference_id": "123456",
"reference": "564635235",
"split_solution_id": "104",
"notify_url": "https://www.yabandpay.com/notify",
"currency": "EUR",
"created_at": 1703831332,
"receivers": [
{
"merchant_mid": "111",
"merchant_name": "111",
"detail_reference_id": "123456-1",
"split_detail_id": "20231229110618372777-1",
"refund_split_detail_id": "20231229110618372777-1-1",
"split_type": "Return",
"split_amount": "2",
"result": "Success",
"description": "分账回退描述1",
"error_msg": null
},
{
"merchant_mid": "222",
"merchant_name": "222",
"detail_reference_id": "123456-1",
"split_detail_id": "20231229110618372777-2",
"refund_split_detail_id": "20231229110618372777-2-1",
"split_type": "Return",
"split_amount": "1",
"result": "Success",
"description": "分账回退描述2",
"error_msg": null
}
],
"type": "splitRefund"
},
"message": ""
}
- 返回参数
| 参数 | 类型 | 描述 |
|---|---|---|
| user | String | 收银员账号的UID |
| split_id | String | 创建分账后的分账单号 |
| split_solution_id | String | 分账方案id |
| state | String | 状态有Success或Failed |
| merchant_mid | String | 分账商户的mid |
| merchant_name | String | 分账商户的商户名 |
| created_at | String | 创建时间戳 |
| currency | String | 订单结算货币，Settlement Currency |
| notify_url | String | 异步通知地址 |
| reference_id | String | 商户方的分账id，不长于32位 |
| reference | String | 描述信息，不长于128位 |
| type | String | 类型，有splitPayment和splitRefund |
| receivers | String | 分账接收方信息，json格式 |
| receivers.merchant_mid | String | 分账接收方的mid |
| receivers.merchant_name | String | 分账接收方的商户名 |
| receivers.split_detail_id | String | 创建分账后的分账明细单号 |
| receivers.detail_reference_id | String | 商户方的分账明细单号 |
| receivers.split_type | String | 分账类型Split或Return |
| receivers.split_amount | String | 分账金额 |
| receivers.result | String | 状态有Success或Failed |
| receivers.description | String | 分账明细描述 |
| receivers.error_msg | String | 分账明细错误信息，result 状态为 Failed 时有值 |