商户发起资金出境请求，需要传微信支付单号，商户出境单号，出境金额等信息 接口请求成功仅代表受理成功，如需知晓业务执行情况请通过查询接口获取。

接口说明

支持商户：

【普通服务商】

请求方式：

【POST】/v3/funds-to-oversea/orders

请求域名：

【主域名】

https://api.mch.weixin.qq.com

使用该域名将访问就近的接入点

【备域名】

https://api2.mch.weixin.qq.com

使用该域名将访问异地的接入点 ，指引点击查看

请求参数

Header HTTP头参数
Authorization 必填 string
请参考 签名认证 生成认证信息
Accept 必填 string
请设置为 application/json
Content-Type 必填 string
请设置为 application/json

Body 包体参数
out_order_id 必填 string(64)
【商户出境单号】 订单的主键，唯一定义此资源的标识，此参数只能由数字，大小写字母_-组成。
由商户在发起资金出境请求时生成，要求在同一个商户号下唯一。
sub_mchid 必填 string(64)
【二级商户号】 申请资金出境的二级商户号
transaction_id 必填 string(64)
【微信订单号】 微信支付返回的支付订单号
amount 必填 integer
【出境金额】 需要出境的人民币金额，单位：分
foreign_currency 必填 string(20)
【境外收款币种】 境外收款币种。
注：微信支付分配的收款人识别号属性下所关联的币种，会校验该币种字段与收款人识别号的相关性。
goods_info 选填 array[GoodsInfo]
【商品信息】 必填字段，goods_info数量不能超过10个
• 属性
seller_info 必填 object
【卖家信息】 卖家信息
• 属性
express_info 选填 object
【物流信息】 物流信息
注意：仅在预售场景且定金订单需单独出境时，该字段可不填；其他场景下，该字段必填
• 属性
payee_info 必填 object
【收款人信息】 收款人信息
• 属性
presale_info 选填 object
【预售信息】 预售信息
注意：定金与尾款对应的订单均需在三年（1096天）内，且定金支付人与尾款支付人需一致
• 属性

请求示例

POST

应答参数

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	商户无权限申请资金出境	商户无权限申请资金出境，请申请相关权限
404	NOT_FOUND	请求的资源不存在	预售订单号或尾款订单号不存在，请检查重试
429	FREQUENCY_LIMITED	资金出境限频	请求频率过高，请于1分钟后重试