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

申请资金出境API

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


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

接口说明

适用对象:电商平台

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

请求方式:POST


path 指该参数为路径参数

query 指该参数为URL参数

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


请求参数

参数名 变量 类型[长度限制] 必填 描述
商户出境单号 out_order_id string[1, 64] body订单的主键,唯一定义此资源的标识,此参数只能由数字,大小写字母_-组成。
由商户在发起资金出境请求时生成,要求在同一个商户号下唯一。
示例值:merchant_1123123
二级商户号 sub_mchid string[1, 64] body申请资金出境的二级商户号
示例值:123456
微信订单号 transaction_id string[1, 128] body微信支付返回的支付订单号
示例值:420000000000000010
出境金额 amount int body需要出境的人民币金额,单位:分
示例值:10
境外收款币种 foreign_currency string[1, 20] body境外收款币种。
注:微信支付分配的收款人识别号属性下所关联的币种,会校验该币种字段与收款人识别号的相关性。
示例值:USD
+ 商品信息 goods_info array body必填字段,goods_info数量不能超过10个
参数名 变量 类型[长度限制] 必填 描述
商品名称 goods_name string[1, 128] 商品的名称
示例值:橘子
商品类目 goods_category string[1, 32] 填写说明:商户自编的分类,可支持最短一级,最长二级的分类。如为二级类目,以/间隔
示例值:家用电器
商品单价 goods_unit_price int 商品单价,单位:分
示例值:1
商品数量 goods_quantity int 商品的数量
示例值:1
+ 卖家信息 seller_info object body卖家信息
参数名 变量 类型[长度限制] 必填 描述
境外卖家经营主体名称 oversea_business_name string[1, 256] 境外卖家经营主体名称
示例值:香港xxxx公司
境外卖家店铺名称 oversea_shop_name string[1, 256] 境外卖家店铺名称
示例值:香港xxx公司xxx店铺
卖家ID seller_id string[1, 128] 商户系统内部的卖家ID
示例值:id2123123123
+ 物流信息 express_info object body物流信息
参数名 变量 类型[长度限制] 必填 描述
物流单号 courier_number string[1, 256] 物流单号
示例值:curier_number_1231
物流商名称 express_company_name string[1, 256] 物流商名称
示例值:国际xxx物流
+ 收款人信息 payee_info object body收款人信息
参数名 变量 类型[长度限制] 必填 描述
收款人识别号 payee_id string[1, 128] 在接入微信支付资金出境服务时,由微信支付分配的收款人识别号。
示例值:ID123112312

请求示例


{
  "amount": 10,
  "express_info": {
    "courier_number": "curier_number_1231",
    "express_company_name": "国际xxx物流"
  },
  "foreign_currency": "USD",
  "goods_info": [
    {
      "goods_category": "家用电器",
      "goods_name": "橘子",
      "goods_quantity": 1,
      "goods_unit_price": 1
    }
  ],
  "out_order_id": "merchant_1123123",
  "payee_info": {
    "payee_id": "ID123112312"
  },
  "seller_info": {
    "oversea_business_name": "香港xxxx公司",
    "oversea_shop_name": "香港xxx公司xxx店铺",
    "seller_id": "id2123123123"
  },
  "sub_mchid": "123456",
  "transaction_id": "420000000000000010"
}

{
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 参数错误 请求参数错误,请重新检查再调用查询剩余可出境余额


技术咨询

文档反馈