申请资金出境

更新时间：2024.11.05

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

接口说明

支持商户：【平台商户】

请求方式：【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

【收款人信息】收款人信息

	属性
	payee_id 　必填 string(128) 【收款人识别号】在接入微信支付资金出境服务时，由微信支付分配的收款人识别号。

presale_info 　选填 object

【预售信息】预售信息
注意：定金与尾款对应的订单均需在三年（1096天）内，且定金支付人与尾款支付人需一致

属性

type 　必填 string

【订单类型】预售场景下订单类型包括定金订单和尾款订单

可选取值：

DEPOSIT: 定金订单

BALANCE: 尾款订单

total_amount 　必填 integer

【预售订单总金额】该笔支付单所售商品的人民币实际价值，单位为分，只能为整数，该信息将用于跨境合规检查，请准确填写。

deposit_transaction_id 　选填 string(64)

【关联定金订单号】尾款订单出境时（type为BALANCE），必须填写关联的定金订单的微信支付订单号。

balance_transaction_id 　选填 string(64)

【关联尾款订单号】定金订单出境时（type为DEPOSIT），需要填写关联的尾款订单的微信支付订单号。
注意：无物流信息，需要定金单独出境时，不必填写该参数

请求示例

POST

1curl -X POST \
2  https://api.mch.weixin.qq.com/v3/funds-to-oversea/orders \
3  -H "Authorization: WECHATPAY2-SHA256-RSA2048 mchid=\"1900000001\",..." \
4  -H "Accept: application/json" \
5  -H "Content-Type: application/json" \
6  -d '{
7    "out_order_id" : "merchant_1123123",
8    "sub_mchid" : "123456",
9    "transaction_id" : "4208450740201411110007820472",
10    "amount" : 10,
11    "foreign_currency" : "USD",
12    "goods_info" : [
13      {
14        "goods_name" : "橘子",
15        "goods_category" : "家用电器",
16        "goods_unit_price" : 1,
17        "goods_quantity" : 1
18      }
19    ],
20    "seller_info" : {
21      "oversea_business_name" : "香港xxxx公司",
22      "oversea_shop_name" : "香港xxx公司xxx店铺",
23      "seller_id" : "id2123123123"
24    },
25    "express_info" : {
26      "courier_number" : "curier_number_1231",
27      "express_company_name" : "国际xxx物流"
28    },
29    "payee_info" : {
30      "payee_id" : "ID123112312"
31    },
32    "presale_info" : {
33      "type" : "DEPOSIT",
34      "total_amount" : 10,
35      "deposit_transaction_id" : "4208450740201411110007820472",
36      "balance_transaction_id" : "4208450740201411110007820472"
37    }
38  }'
39

应答参数

200 OK

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

1{
2  "out_order_id" : "merchant123123",
3  "sub_mchid" : "1231231",
4  "order_id" : "42000000000_123123",
5  "result" : "ACCEPT",
6  "fail_reason" : "DEPARTURE_AMOUNT_NO_ENOUGH",
7  "amount" : 21,
8  "foreign_amount" : 20,
9  "foreign_currency" : "USD",
10  "rate" : 650000000,
11  "exchange_rate_time" : "2015-05-20T13:29:35+08:00",
12  "estimate_exchange_rate_time" : "2015-05-20T13:29:35+08:00",
13  "departure_amount" : 20,
14  "fee" : 1,
15  "charge_mchid" : "1231231",
16  "charge_account_type" : "BASIC"
17}
18

错误码

公共错误码

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

业务错误码

状态码	错误码	描述	解决方案
403	NO_AUTH	商户无权限申请资金出境	商户无权限申请资金出境，请申请相关权限
404	NOT_FOUND	请求的资源不存在	预售订单号或尾款订单号不存在，请检查重试
429	FREQUENCY_LIMITED	资金出境限频	请求频率过高，请于1分钟后重试

文档是否有帮助

更多支持

开发文档(商户)开发文档(V2版)开发者社区微信开放平台微信公众平台腾讯客服