最新更新时间:2022.04.19 版本说明
电商收付通中,针对多次请求出境的场景,商家需要查询可出境金额之后再进行出境请求
其中:订单剩余可出境金额=订单可出境金额-已累计出境金额
适用对象:电商平台
请求URL:https://api.mch.weixin.qq.com/v3/funds-to-oversea/transactions/{transaction_id}/available_abroad_amounts
请求方式:GET
path 指该参数为路径参数
query 指该参数为URL参数
body 指该参数需在请求JSON传参
参数名 | 变量 | 类型[长度限制] | 必填 | 描述 |
---|---|---|---|---|
微信支付订单号 | transaction_id | string[1, 32] | 是 | path微信支付返回的支付订单号 示例值:4208450740201411110007820472 |
二级商户号 | sub_mchid | string[1, 32] | 是 | query查询剩余可出境金额的二级商户号 示例值:1900000109 |
https://api.mch.weixin.qq.com/v3/funds-to-oversea/transactions/4208450740201411110007820472/available_abroad_amounts?sub_mchid=1900000109
参数名 | 变量 | 类型[长度限制] | 必填 | 描述 |
---|---|---|---|---|
微信支付订单号 | transaction_id | string[1, 32] | 是 | 微信支付返回的支付订单号 示例值:4208450740201411110007820472 |
订单剩余可出境金额 | available_abroad_amount | int | 是 | 订单剩余可出境金额,单位: 分 示例值:21 |
{
"available_abroad_amount": 21,
"transaction_id": "4208450740201411110007820472"
}
状态码 | 错误码 | 描述 | 解决方案 |
---|---|---|---|
500 | SYSTEM_ERROR | 接口返回错误 | 请不要更换微信订单号,请使用相同参数再次调用API。 |
400 | PARAM_ERROR | 参数错误 | 请求参数错误,请重新检查再调用查询剩余可出境余额 |
401 | SIGN_ERROR | 签名错误 | 请检查签名参数和方法是否都符合签名算法要求 |
429 | FREQUENCY_LIMITED | 频率限制 | 请降低频率后重试 |
400 | INVALID_REQUEST | 请求参数符合参数格式,但不符合业务规则 | 此状态代表查询订单剩余出境可用余额失败,商户可根据具体的错误提示做相应的处理。 |
403 | NO_AUTH | 商户无权限申请资金出境 | 商户无权限申请资金出境,请申请相关权限 |