商户进件
特约商户进件
基础支付
JSAPI支付
APP支付
H5支付
Native支付
小程序支付
合单支付
付款码支付
经营能力
支付即服务
点金计划
行业方案
电商收付通(商户进件)
电商收付通(普通支付)
电商收付通(合单支付)
电商收付通(分账)
电商收付通(补差)
电商收付通(退款)
电商收付通(余额查询)
电商收付通(商户提现)
电商收付通(跨境付款)
电商收付通(下载账单)
智慧商圈
微信支付分停车服务
营销工具
代金券
商家券
委托营销
支付有礼
小程序发券插件
H5发券
图片上传(营销专用)
现金红包
资金应用
分账
连锁品牌分账
风险合规
商户开户意愿确认
消费者投诉2.0
商户违规通知回调
其他能力
图片上传
视频上传
微信支付平台证书

查询出境结果API

最新更新时间:2022.05.30 版本说明


根据微信支付单号+商户出境单号,查询出境结果,出境失败会返回错误码

接口说明

适用对象:电商平台

请求URL:https://api.mch.weixin.qq.com/v3/funds-to-oversea/orders/{out_order_id}

请求方式:GET


path 指该参数为路径参数

query 指该参数为URL参数

body 指该参数需在请求JSON传参


请求参数

参数名 变量 类型[长度限制] 必填 描述
商户出境单号 out_order_id string[1, 64] path本次需要查询的商户出境单号,由商户在发起资金出境请求时生成。
示例值:merchant123123
二级商户号 sub_mchid string[1, 64] query申请资金出境的二级商户号
示例值:1231231
微信支付订单号 transaction_id string[1, 128] query微信支付返回的支付订单号
示例值:4200000000000

请求示例


https://api.mch.weixin.qq.com/v3/funds-to-oversea/orders/merchant123123?sub_mchid=1231231&transaction_id=4200000000000

{
JAVA示例代码
}

返回参数

参数名 变量 类型[长度限制] 必填 描述
商户出境单号 out_order_id string[1, 64] 订单的主键,唯一定义此资源的标识,此参数只能由数字,大小写字母_-组成。
由商户在发起资金出境请求时生成,要求在同一个商户号下唯一。
示例值:merchant123123
二级商户号 sub_mchid string[1, 64] 申请资金出境的二级商户号
示例值:1231231
微信出境单号 order_id string[1, 128] 微信出境单号
示例值:42000000000_123123
出境结果 result string[1, 128] 出境的结果, 枚举值:
ACCEPT:已受理
SUCCESS:出境成功
FAIL:出境失败
示例值:ACCEPT
出境失败的原因 fail_reason string[1, 128] 当result为FAIL时,会出现此字段,标明出境失败原因,如果是SYSTEM_ERROR可以重新发起重试
失败原因:
MCHID_FROZEN:商户已冻结,转账失败
DEAL_TIMEOUT:单据已过期
TRADE_SUIT:交易订单被交易投诉冻结
DEPARTURE_AMOUNT_NO_ENOUGH:剩余可出境金额不足
BASIC_AMOUNT_NO_ENOUGH:商户基本户余额不足
PAYMENT_NOT_SUPPORT_DEPARTURE:该笔订单不支持出境
OUT_ORDER_ID_DUPLICATE:同一个out_order_id用于不同的支付订单
RISK_CONTROL:订单被风控拦截
SYSTEM_ERROR:系统失败
FEE_ACCOUNT_NOT_OPEN:电商平台承担手续费但是未开通手续费账户或者手续费账户被处罚
PAYER_ACCOUNT_ABNORMAL:资金出境方账户异常
GOODS_INFO_ILLEGAL: 资金出境申请商品信息非法
FOREIGN_CURRENCY_NOT_SUPPORT: 不支持的币种类型,请换币种重试,目前仅支持八大币种:USD、HKD、JPY、EUR、GBP、CAD、AUD、SGD
示例值:DEPARTURE_AMOUNT_NO_ENOUGH
请求出境人民币金额 amount int 需要出境的人民币金额,单位:分
示例值:21
真实出境外币金额 foreign_amount int 真实出境的外币金额,单位:该币种最小计价单位,当result为SUCCESS时有这个字段
示例值:20
外币币种 foreign_currency string[1, 20] 出境的目标币种,由商户在资金出境申请接口传入。
示例值:USD
汇率 rate int 当result为SUCCESS时有这个字段,标价币种与支付币种的兑换比例乘以10的8次方即为此值,例如美元兑换人民币的比例为6.5,则rate=650000000
示例值:650000000
购汇时间 exchange_rate_time string[1, 64] 当result为SUCCESS时有这个字段。遵循rfc3339标准格式,格式为yyyy-MM-DDTHH:mm:ss+TIMEZONE,yyyy-MM-DD表示年月日,T出现在字符串中,表示time元素的开头,HH:mm:ss表示时分秒,TIMEZONE表示时区(+08:00表示东八区时间,领先UTC 8小时,即北京时间)。例如:2015-05-20T13:29:35+08:00表示,北京时间2015年5月20日 13点29分35秒。
示例值:2015-05-20T13:29:35+08:00
预计购汇时间 estimate_exchange_rate_time string[1, 64] 当result为ACCEPT时可能有这个字段,以实际结果为准。
遵循rfc3339标准格式,格式为yyyy-MM-DDTHH:mm:ss+TIMEZONE,yyyy-MM-DD表示年月日,T出现在字符串中,表示time元素的开头,HH:mm:ss表示时分秒,TIMEZONE表示时区(+08:00表示东八区时间,领先UTC 8小时,即北京时间)。例如:2015-05-20T13:29:35+08:00表示,北京时间2015年5月20日 13点29分35秒。
示例值:2015-05-20T13:29:35+08:00
真实出境人民币金额 departure_amount int 真正出境的人民币金额,单位:分,如果是二级商户承担手续费且非收支分离,该金额=请求出境金额-手续费,否则该金额=请求出境金额
示例值:20
手续费人民币金额 fee int 资金出境手续费人民币金额,单位:分
示例值:1
手续费承担商户号 charge_mchid string[1,64] 手续费承担商户号
示例值:1231231
手续费承担账户 charge_account_type string 基本账户或者手续费账户
BASIC:基本账户
FEES:手续费账户
示例值:BASIC

返回示例


{
  "amount": 21,
  "charge_account_type": "BASIC",
  "charge_mchid": "1231231",
  "departure_amount": 20,
  "estimate_exchange_rate_time": "2015-05-20T13:29:35+08:00",
  "exchange_rate_time": "2015-05-20T13:29:35+08:00",
  "fail_reason": "DEPARTURE_AMOUNT_NO_ENOUGH",
  "fee": 1,
  "foreign_amount": 20,
  "foreign_currency": "USD",
  "order_id": "42000000000_123123",
  "out_order_id": "merchant123123",
  "rate": 650000000,
  "result": "ACCEPT",
  "sub_mchid": "1231231"
}
                    

http://2323weixin.qq.com
                    

错误码公共错误码

状态码 错误码 描述 解决方案
403 NO_AUTH 商户无权限申请资金出境 商户无权限申请资金出境,请申请相关权限
400 PARAM_ERROR 参数错误 请求参数错误,请重新检查再调用查询剩余可出境余额


技术咨询

文档反馈