查询出境结果

更新时间:2023.05.25

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

# 接口说明

支持商户:
【普通服务商】
请求方式:
【GET】/v3/funds-to-oversea/orders/{out_order_id}
请求域名:
【主域名】
https://api.mch.weixin.qq.com
使用该域名将访问就近的接入点
【备域名】
https://api2.mch.weixin.qq.com
使用该域名将访问异地的接入点 ,指引点击查看

# 请求参数

    Header HTTP头参数
  • Authorization 必填 string
    请参考 签名认证 生成认证信息
  • Accept 必填 string
    请设置为 application/json
    Path 路径参数
  • out_order_id 必填 string(64)
    【商户出境单号】 本次需要查询的商户出境单号,由商户在发起资金出境请求时生成。
    Query 查询参数
  • sub_mchid 必填 string(64)
    【二级商户号】 申请资金出境的二级商户号
  • transaction_id 必填 string(64)
    【微信支付订单号】 微信支付返回的支付订单号

请求示例

GET

# 应答参数

    200OK
  • out_order_id 必填 string(64)
    【商户出境单号】 订单的主键,唯一定义此资源的标识,此参数只能由数字,大小写字母_-组成。
    由商户在发起资金出境请求时生成,要求在同一个商户号下唯一。
  • sub_mchid 必填 string(64)
    【二级商户号】 申请资金出境的二级商户号
  • order_id 必填 string(128)
    【微信出境单号】 微信出境单号
  • result 必填 string(128)
    【出境结果】 出境的结果, 枚举值:
    * ACCEPT:已受理
    * SUCCESS:出境成功
    * FAIL:出境失败
  • fail_reason 选填 string(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
    * PAYEE_INFO_ILLEGAL:校验收款人信息失败
    * PRESALE_INFO_ILLEGAL:资金出境申请预售信息非法
    * 示例值:DEPARTURE_AMOUNT_NO_ENOUGH
  • amount 必填 integer
    【请求出境人民币金额】 需要出境的人民币金额,单位:分
  • foreign_amount 选填 integer
    【真实出境外币金额】 真实出境的外币金额,单位:该币种最小计价单位,当result为SUCCESS时有这个字段
  • foreign_currency 必填 string(20)
    【外币币种】 出境的目标币种,由商户在资金出境申请接口传入。
  • rate 选填 integer
    【汇率】 当result为SUCCESS时有这个字段,标价币种与支付币种的兑换比例乘以10的8次方即为此值,例如美元兑换人民币的比例为6.5,则rate=650000000
  • exchange_rate_time 选填 string(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秒。
  • estimate_exchange_rate_time 选填 string(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秒。
  • departure_amount 选填 integer
    【真实出境人民币金额】 真正出境的人民币金额,单位:分,如果是二级商户承担手续费且非收支分离,该金额=请求出境金额-手续费,否则该金额=请求出境金额
  • fee 选填 integer
    【手续费人民币金额】 资金出境手续费人民币金额,单位:分
  • charge_mchid 选填 string(64)
    【手续费承担商户号】 手续费承担商户号
  • charge_account_type 选填 string
    【手续费承担账户】 基本账户或者手续费账户
    可选取值:
    • BASIC: 基本账户
    • FEES: 手续费账户

应答示例

200 OK

# 错误码

# 公共错误码

状态码 错误码 描述 解决方案
400 PARAM_ERROR 参数错误 请根据错误提示正确传入参数
400 INVALID_REQUEST HTTP 请求不符合微信支付 APIv3 接口规则 请参阅 接口规则
401 SIGN_ERROR 验证不通过 请参阅 签名常见问题
500 SYSTEM_ERROR 系统异常,请稍后重试 请稍后重试

# 业务错误码

状态码 错误码 描述 解决方案
403 NO_AUTH 商户无权限申请资金出境 商户无权限申请资金出境,请申请相关权限
反馈
咨询
目录