测试环境商家账户是用来进行支付业务体验的账号，交易中产生的一切信息均为生产环境数据，由于体验业务特点，不会产生清算资金划拔，所以使用测试商家账号时请务必使用小额支付（建议：小于0.1元）。
- 资料下载
- 技术资料
- 接口能力
- 进件系统
- 报文数据元说明
- 商管系统联调说明
- 参数字典说明
- 9进件类接口
- 9.1 图片上传
- 9.2 商户信息录入
- 9.3 商户信息补件
- 9.4 商户异步通知回调
- 9.5 商户审核结果查询
- 9.6 商户信息查询
- 9.7 商户信息变更
- 9.8 新增终端
- 9.9 终端变更
- 9.10 结算账户变更
- 9.11 商户功能变更
- 9.12 参数查询
- 9.13 查询授权码
- 9.14 机具序列号入库接口
- 9.15 商户签约申请接口
- 9.16 易生侧签约电子协议下载
- 9.17 商户电子协议号变更
- 9.18 终端授权码重置接口
- 9.19 终端注销
- 9.20 商户注销
- 9.21 终端序列号TUSN校验
- 9.22 终端序列号查询终端信息
- 9.23 银联入驻结果查询
- 9.24 微信支付宝重新入驻
- 9.25 更新银联报备服务商
- 9.26 更新代理商编号（特定使用）
- 9.27 商户、终端操作通知
- 9.28 终端码牌、小白盒绑定解绑
- 9.29 电子协议签署查询
- 10分账绑定类接口
- 11限额类接口
- 12营销类接口
- 13支付宝配置类接口
- 14微信配置类接口
- 易企通1.0
- 云易收（云收银）
- 电子协议
- 分账、退款
- 网支中台
- 易生鉴权
- 微收单-不对接
- 易生代付
- 银行卡接口规范
- 数据模型
- Schemas
- 易生鉴权-应答码
- CommonRespVO<<鉴权>>
- CommonRespVO<<分账-增加接收方>>
- CommonRespVO<<云易收-请求-通用信息>>
- CommonRespVO<<云易收-请求-地理信息>>
- CommonRespVO<<云易收-业务数据-bizData>>
- CommonRespVO<<电子协议-响应信息>>
- CommonRespVO<<分账-请求-通用信息>>
- CommonReqVO<<分账-分账关系-bizData通用信息>>
- CommonReqVO<<分账-分账-bizData通用信息>>
- CommonReqVO<<分账-分账-bizData通用信息-子订单明细>>
- CommonReqVO<<分账-退货-bizData通用信息>>
- CommonRespVO<<易生代付-请求-通用信息>>
- CommonRespVO<<易生代付-请求-异步通知>>
- CommonRespVO<<易生代付-Datainfo-附加信息说明>>
- CommonRespVO<<易生代付-返回-通用信息>>
- CommonReqVO<<商管进件-请求-通用信息>>
- CommonReqVO<<商管进件-请求-通用信息-图片上传外>>
- CommonRespVO<<商管进件-返回-通用信息>>
- 易生鉴权-应答码 Copy
- APP
- ApiLoginAccount
- LiquidationCommonReqVO«RealTimeOldQueryReqVO»
- AliGoodsDetail
- ApiModifyPwd
- RealTimeOldQueryReqVO
- AliTradeFundBillUnder
- ApiResult«JSONArray»
- TradeCommonReqVO«GuaranteeApplyReqVO»
- AppResp
- ApiResult«JSONObject»
- GuaranteeApplyReqVO
- AppendReqData
- AppendRespData
- CommonReqVO«APP»
- CommonReqVO«JSAPI»
- CustomCodeVo
- CommonReqVO«NATIVE»
- CustomNameVo
- CommonReqVO«QueryAppendReq»
- CommonReqVO«ScanPay»
- CommonReqVO«SupportReq»
- CommonReqVO«wxAppidJsapi»
- RefundAuth
- CommonReqVO«获取微信OpenId-请求»
- CommonReqVO«银联二维码-JSAPI获取用户标识-请求»
- CommonRespVO
- LiquidationCommonRespVO«RealTimeQueryRespVO»
- RealTimeQueryRespVO
- CommonRespVO«GuaranteeApplyRespVO»
- GuaranteeApplyRespVO
- CommonRespVO«AppResp»
- CommonRespVO«JsapiResp»
- LiquidationCommonReqVO«BalanceQueryReqVO»
- CommonRespVO«NativeResp»
- BalanceQueryReqVO
- CommonRespVO«QueryAppendResp»
- TradeOtherCommonReqVO«GuaranteeCancelReqVO»
- CommonRespVO«QueryResp»
- GuaranteeCancelReqVO
- CommonRespVO«ScanPayResp»
- LiquidationCommonReqVO«SettleInfoQueryReqVO»
- CommonRespVO«银联二维码-JSAPI获取用户标识-返回»
- SettleInfoQueryReqVO
- Type
- CommonRespVO«GuaranteeCancelRespVO»
- DisCount
- GuaranteeCancelRespVO
- 交易请求信息«ApiLoginAccount»
- LiquidationCommonRespVO«BalanceQueryRespVO»
- JSAPI
- BalanceQueryRespVO
- 交易请求信息«ApiModifyPwd»
- LiquidationCommonRespVO«List«SettleInfoQueryRespVO»»
- JsapiResp
- SettleInfoQueryRespVO
- 交易请求信息«ESign»
- CommonRespVO«GuaranteeNotarizeRespVO»
- NATIVE
- GuaranteeNotarizeRespVO
- 交易请求信息«MpsOrderSearchVo»
- CommonRespVO«GuaranteeQueryRespVO»
- NativeResp
- GuaranteeQueryRespVO
- 交易请求信息«OrderSearchVo»
- TradeOtherCommonReqVO«GuaranteeNotarizeReqVO»
- PayDetail
- GuaranteeNotarizeReqVO
- 交易请求信息«RefundAuth»
- TradeOtherCommonReqVO«GuaranteeQueryReqVO»
- QrAcqAddnData
- GuaranteeQueryReqVO
- 交易请求信息«ReqMerchant»
- QrCouponInfo
- 交易请求信息«ReqQueryAccount»
- QrDctDetail
- 交易请求信息«ReqTradeDtl»
- QrGoodsInfo
- 交易请求信息«ReqTradeTotal»
- QrIssAddnData
- 交易请求信息«StlmDtl»
- QrLimitAmt
- 交易请求信息«Stlm»
- QrOrderInfo
- 交易请求信息«TaxReq»
- QrPayerInfo
- 交易请求信息«Trade»
- QueryAppendReq
- 交易请求信息«支付宝IOT喇叭绑定vo»
- QueryAppendResp
- 支付宝IOT喇叭绑定vo
- QueryResp
- Reserved
- RiskInfo
- ScanPay
- ScanPayResp
- StoreInfo
- SupportReq
- TerminalInfo
- UnQrAppInfo
- UnQrAppInstalTransInfo
- UnQrAppReserved
- WxDetail
- WxGoodsDetail
- WxSceneInfo
- wxAppidJsapi
- 付款人信息
- 获取微信OpenId-请求
- 银联二维码-JSAPI获取用户标识-请求
- 银联二维码-JSAPI获取用户标识-返回
- API接口
实时退款
测试环境
https://t-wapi.bhecard.com:6111
测试环境
https://t-wapi.bhecard.com:6111
POST
https://t-wapi.bhecard.com:6111
最后修改时间：2025-06-11 07:08:35
退货接口，用于合单支付、带有分账标签、无分账标签的原支付订单退货退款，支持部分退款、全额退款。
退款金额规则说明：
1、原订单有分账标签：退款申请金额须小于等于原支付订单剩余可退金额，即原订单未分账的金额均可退款。
2、原订单无分账标签：退款申请金额须小于等于原支付订单剩余可退金额（部分退款情况下存在已退金额，订单剩余可退金额=原订单金额-已退款金额），且小于等于商户当日正向交易余额（正向交易金额-已退款金额）。
（1）举例1：昨日仅发生一笔正向交易金额400元（待今日结算），今日正向交易500元，第一笔退款300元可成功，第二笔退款为昨日订单的全额退款400元（大于此时“当日正向交易余额”200元），因此退款失败。
（2）举例2：昨日仅发生一笔正向交易金额400元（待今日结算），今日仅发生一笔正向交易500元，第一笔退款为昨日订单的全额退款400元可成功，第二笔退款为今日正向交易的全额退款500元（大于此时“当日正向交易余额”100元），因此退款失败。
1、无需分账的原订单退款、分账前发起退款可调用该接口
2、分账当日的退款可先发起“分账撤销”后再调用本接口，退款金额需小于等于待分账金额（=清算总额-已分账金额-已退款金额），若大于则会退款失败 ，或可选择极速退款
3、原支付订单带分账标签的退款，同一笔订单部分退款次数不多于20次
4、合单支付后的总单退款或子单退款，也调用该接口，上送总订单号或子订单号即可
5、满足要求的退款将实时原路退回
请求参数
Body 参数application/json
示例
{
"orgId": "ORG000000001215",
"orgMercode": "531000013027106",
"orgTermno": "string",
"orgTrace": "ORG073031190202304251234200048",
"prodCode": "string",
"sign": "string",
"signType": "string",
"orgSmercode": "string",
"orgInfo": "string",
"sysRetCode": "00",
"orgGpstype": "string",
"orgLongitude": "string",
"orgLatitude": "string",
"orgBasestation": "string",
"orgDeviceIp": "string",
"bizData": {
"oriOrgTrace": "string",
"oriOutTrace": "string",
"oriBizDate": "string",
"transAmt": "string"
}
}请求示例代码
Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://t-wapi.bhecard.com:6111/ledger/mposrefund' \
--header 'Content-Type: application/json' \
--data-raw '{
"orgId": "ORG000000001215",
"orgMercode": "531000013027106",
"orgTermno": "string",
"orgTrace": "ORG073031190202304251234200048",
"prodCode": "string",
"sign": "string",
"signType": "string",
"orgSmercode": "string",
"orgInfo": "string",
"sysRetCode": "00",
"orgGpstype": "string",
"orgLongitude": "string",
"orgLatitude": "string",
"orgBasestation": "string",
"orgDeviceIp": "string",
"bizData": {
"oriOrgTrace": "string",
"oriOutTrace": "string",
"oriBizDate": "string",
"transAmt": "string"
}
}'返回响应
🟢200成功
application/json
Body
示例
{
"sysRetCode": "000007",
"sysRetMsg": "原订单获取失败,稍后重试",
"orgId": "ORG000000001136",
"orgMerCode": "531000013010845",
"orgTermNo": "32812114",
"prodTrace": "",
"orgTrace": "ORG0478520230221150236ub2yf7",
"prodCode": "",
"sign": "Xht9/B6/k28gZY+JDY5dYF84qHPkk7MM8wcJsvwavoQD9Dk4G78Z40vhQj3CLLDtJvVM8eLDWzPQgcMUBlL7lsuDEu+2cGNUxR7H9/oqjcjEbRWVgyXjHzCvNv1vpF5WSiLSJ1+qd4JTbNiCQ+AZAq7jwMmJRQKeHlXZKTFUiAw=",
"signType": "SHA256withRSA",
"bizData": {
"tradeRetCode": "07",
"tradeRetMsg": "原订单获取失败,稍后重试",
"oriOrgTrace": "ORG0651620230415110635201598",
"transAmt": "10"
}
}修改于 2025-06-11 07:08:35