微信支付境外文档-分账

接口说明

适用对象：直连模式机构模式

请求URL：https://apihk.mch.weixin.qq.com/v3/global/profit-sharing/orders/{out_order_no}

请求方式：get

path 指该参数为路径参数

query 指该参数为URL参数

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

请求参数

参数名	变量	类型[长度限制]	必填	描述
二级商户号	sub_mchid	string[1, 32]	否	query微信支付分配的商户号，请与微信支付订单的二级商户号保持一致。（直连商户不需要，服务商/机构模式下必填）示例值：1900000109
微信支付订单号	transaction_id	string[1, 32]	是	query微信支付订单号示例值：4208450740201411110007820472
商户分账单号	out_order_no	string[1, 64]	是	path商户系统内部的分账单号，在商户系统内部唯一（单次分账、多次分账、完结分账应使用不同的商户分账单号），同一分账单号多次请求等同一次。只能是数字、大小写字母_- 示例值：P20150806125346

请求示例

URL


https://apihk.mch.weixin.qq.com/v3/global/profit-sharing/orders/P20150806125346?sub_mchid=1900000109&transaction_id=4208450740201411110007820472


｛
JAVA示例代码
｝

返回参数

参数名

变量

类型[长度限制]

必填

描述

二级商户号

sub_mchid

string[1, 32]

否

微信支付分配的商户号
示例值：1900000109

微信支付订单号

transaction_id

string[1, 32]

是

微信支付订单号
示例值：4208450740201411110007820472

商户分账单号

out_order_no

string[1, 64]

是

商户分账单号，同请求入参。
示例值：P20150806125346

微信分账单号

order_id

string[1, 64]

是

微信分账单号，微信系统返回的唯一标识。
示例值：3008450740201411110007820472

分账单状态

state

string

是

分账单状态（每个接收方的分账结果请查看receivers中的result字段）。
PROCESSING：处理中，
FINISHED：分账完成，
示例值：FINISHED

+ 分账接收方列表

receivers

array

是

分账接收方列表
商户在发起分账请求或解冻剩余资金请求时，对同一笔订单可分给多个接收方（包括解冻给出资方），分账明细描述了每笔分给一个接收方的资金的状态。

参数名	变量	类型[长度限制]	必填	描述
分账币种	currency	string[3, 3]	是	分账币种，同请求入参。示例值：CNY
分账金额	amount	int	是	分账金额，同请求入参。示例值：100
分账描述	description	string[1, 80]	是	商户传入的分账描述，同请求入参。示例值：分给商户1900000110
接收方类型	type	string	是	接收方类型，同请求入参。 MERCHANT_ID：商户号， PERSONAL_OPENID：个人OpenID，由商户APPID转换得到 PERSONAL_SUB_OPENID：是个人Sub_OpenID，由二级商户APPID转换得到示例值：MERCHANT_ID
接收方账号	account	string[1, 64]	是	接收方账号，同请求入参。示例值：1900000109
分账明细结果	result	string	是	每一笔分账明细转账的结果。 PENDING：待分账 SUCCESS：分账成功 CLOSED：已关闭示例值：SUCCESS
分账明细失败原因	fail_reason	string	否	分账明细失败原因。在分账明细结果为"CLOSED"时才会被设置。 NO_RELATION：分账关系已解除 SUB_MERCHANT_FRONEN：二级商户被冻结 MCH_CONTRACT_SETTLE_OFF：商户结算合同为关闭结算状态 MCH_CONTRACT_FROZEN：商户结算合同被冻结 ACCOUNT_ABNORMAL：分账接收账户异常 RECEIVER_HIGH_RISK：高风险接收方 RECEIVER_REAL_NAME_NOT_VERIFIED：接收方未实名 NO_AUTH：分账权限已解除 DEFAULT_ERROR：默认错误示例值：ACCOUNT_ABNORMAL
分账明细创建时间	create_time	string[1, 64]	是	分账明细创建时间，遵循RFC3339标准格式示例值：2015-05-20T13:29:35.120+08:00
分账明细完成时间	finish_time	string[1, 64]	否	分账明细完成时间，遵循RFC3339标准格式。在分账明细结果为"SUCCESS"或"CLOSED"时才会被设置。示例值：2015-05-20T13:29:35.120+08:00
分账明细单号	detail_id	string[1, 64]	是	微信分账明细单号，每笔分账业务执行的明细单号。示例值：36011111111111111111111
分账明细类型	detail_type	string	是	分账明细分为两类，包括分出给其他接收方和解冻给出资方。可由该字段来区分，若明细类型为UNFREEZE_TO_SPONSOR(解冻给出资方)时，分账明细中还会返回出资方结算币种、结算金额、汇率值等信息。 DISTRIBUTE_TO_OTHERS：分出给其他接收方 UNFREEZE_TO_SPONSOR：解冻给出资方出境示例值：DISTRIBUTE_TO_OTHERS
出资方结算币种	settlement_currency	string[3, 3]	否	出资方的结算币种，明细类型为UNFREEZE_TO_SPONSOR(解冻给出资方)时该字段才会被设置。示例值：HKD
出资方结算金额	settlement_amount	int	否	该笔明细通过换汇后最终结算给出资方的金额，采用最小币种单位。示例值：110
汇率值	rate	int	否	分账币种与结算币种的兑换比例乘以10的8次方即为此值。若分账币种与结算币种均为人民币，则兑换比值为1，汇率值为100,000,000; 若结算币种为美元，假设美元兑换人民币的比例为6.5，则汇率值为650,000,000。示例值：81000000

返回示例

正常示例


{
  "order_id": "3008450740201411110007820472",
  "out_order_no": "P20150806125346",
  "receivers": [
    {
      "account": "1900000109",
      "amount": 100,
      "create_time": "2015-05-20T13:29:35.120+08:00",
      "currency": "CNY",
      "description": "分给商户1900000110",
      "detail_id": "36011111111111111111111",
      "detail_type": "DISTRIBUTE_TO_OTHERS",
      "fail_reason": "ACCOUNT_ABNORMAL",
      "finish_time": "2015-05-20T13:29:35.120+08:00",
      "rate": 81000000,
      "result": "SUCCESS",
      "settlement_amount": 110,
      "settlement_currency": "HKD",
      "type": "MERCHANT_ID"
    }
  ],
  "state": "FINISHED",
  "sub_mchid": "1900000109",
  "transaction_id": "4208450740201411110007820472"
}


http://2323weixin.qq.com

错误码

状态码	错误码	描述	解决方案
404	NOT_FOUND	分账指令不存在，请检查外部指令单号(out_order_no)是否填写正确	请检查外部指令单号(out_order_no)是否填写正确
400	INVALID_REQUEST	查询分账结果时商户信息与原指令不一致	请检查外部指令单号(out_order_no)/微信支付单号(transaction_id)/二级商户号(sub_mchid)是否填写正确
400	INVALID_REQUEST	查询分账结果时微信支付订单与原指令信息不一致	请检查外部指令单号(out_order_no)/微信支付单号(transaction_id)是否填写正确
403	NO_AUTH	商户未签约境外分账产品能力	请参考产品流程和接入准备，确认商户具有分账权限后再发起请求
403	NO_AUTH	商户已开通分账产品能力，等待生效中(一般为第二天才生效)	开通分账产品能力当天不能发起分账，请等待第二天后发起请求
403	NO_AUTH	分账接收方境外权限被处罚	请确认分账接收方均合法合规后，请发起分账请求
403	NO_AUTH	商户父子关系不存在，请使用正确的二级商户号发起请求	请检查二级商户号(sub_mchid)是否填写正确

WeChat Pay

Feedback

Feedback

Submitted successfully

Feedback

Network exception, please try again later

境外分账API

查询分账结果API

接口说明

请求参数

请求示例

返回参数

返回示例

错误码

版本说明