| 申请资金出境 | 您所在的位置：网站首页 › H5商城收付通 › 申请资金出境 |
|
商户发起资金出境请求，需要传微信支付单号，商户出境单号，出境金额等信息 接口请求成功仅代表受理成功，如需知晓业务执行情况请通过查询接口获取。 # 接口说明 支持商户： 【普通服务商】 请求方式： 【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 必填 SellerInfo 【卖家信息】 卖家信息 属性 express_info 选填 ExpressInfo 【物流信息】 物流信息注意：仅在预售场景且定金订单需单独出境时，该字段可不填；其他场景下，该字段必填 属性 payee_info 必填 PayeeInfo 【收款人信息】 收款人信息 属性 presale_info 选填 PresaleInfo 【预售信息】 预售信息注意：定金与尾款对应的订单均需在三年（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分钟后重试 |
| CopyRight 2018-2019 实验室设备网 版权所有 |