查询出境结果
更新时间:2023.05.25根据微信支付单号+商户出境单号,查询出境结果,出境失败会返回错误码
# 接口说明
支持商户:
【普通服务商】
请求方式:
【GET】/v3/funds-to-oversea/orders/{out_order_id}
请求域名:
【主域名】
https://api.mch.weixin.qq.com
使用该域名将访问就近的接入点【备域名】
https://api2.mch.weixin.qq.com
使用该域名将访问异地的接入点 ,指引点击查看
# 请求参数
- Authorization 必填请参考 签名认证 生成认证信息
- Accept 必填请设置为
application/json
Header HTTP头参数
- out_order_id 必填【商户出境单号】 本次需要查询的商户出境单号,由商户在发起资金出境请求时生成。
Path 路径参数
- sub_mchid 必填【二级商户号】 申请资金出境的二级商户号
- transaction_id 必填【微信支付订单号】 微信支付返回的支付订单号
Query 查询参数
请求示例
GET
# 应答参数
- out_order_id 必填【商户出境单号】 订单的主键,唯一定义此资源的标识,此参数只能由数字,大小写字母_-组成。
由商户在发起资金出境请求时生成,要求在同一个商户号下唯一。 - sub_mchid 必填【二级商户号】 申请资金出境的二级商户号
- order_id 必填【微信出境单号】 微信出境单号
- result 必填【出境结果】 出境的结果, 枚举值:
* ACCEPT:已受理
* SUCCESS:出境成功
* FAIL:出境失败 - fail_reason 选填【出境失败的原因】 当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
* PAYEE_INFO_ILLEGAL:校验收款人信息失败
* PRESALE_INFO_ILLEGAL:资金出境申请预售信息非法
* 示例值:DEPARTURE_AMOUNT_NO_ENOUGH - amount 必填【请求出境人民币金额】 需要出境的人民币金额,单位:分
- foreign_amount 选填【真实出境外币金额】 真实出境的外币金额,单位:该币种最小计价单位,当result为SUCCESS时有这个字段
- foreign_currency 必填【外币币种】 出境的目标币种,由商户在资金出境申请接口传入。
- rate 选填【汇率】 当result为SUCCESS时有这个字段,标价币种与支付币种的兑换比例乘以10的8次方即为此值,例如美元兑换人民币的比例为6.5,则rate=650000000
- exchange_rate_time 选填【购汇时间】 当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秒。
- estimate_exchange_rate_time 选填【预计购汇时间】 当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秒。 - departure_amount 选填【真实出境人民币金额】 真正出境的人民币金额,单位:分,如果是二级商户承担手续费且非收支分离,该金额=请求出境金额-手续费,否则该金额=请求出境金额
- fee 选填【手续费人民币金额】 资金出境手续费人民币金额,单位:分
- charge_mchid 选填【手续费承担商户号】 手续费承担商户号
- charge_account_type 选填【手续费承担账户】 基本账户或者手续费账户
可选取值:BASIC
: 基本账户FEES
: 手续费账户
200OK
应答示例
200 OK
# 错误码
# 公共错误码
状态码 | 错误码 | 描述 | 解决方案 |
---|---|---|---|
400 | PARAM_ERROR | 参数错误 | 请根据错误提示正确传入参数 |
400 | INVALID_REQUEST | HTTP 请求不符合微信支付 APIv3 接口规则 | 请参阅 接口规则 |
401 | SIGN_ERROR | 验证不通过 | 请参阅 签名常见问题 |
500 | SYSTEM_ERROR | 系统异常,请稍后重试 | 请稍后重试 |
# 业务错误码
状态码 | 错误码 | 描述 | 解决方案 |
---|---|---|---|
403 | NO_AUTH | 商户无权限申请资金出境 | 商户无权限申请资金出境,请申请相关权限 |
文档是否有帮助