指定身份支付

更新时间:2025.04.23

原有下单接口默认不支持带实名参数,需联系相关微信支付工作人员申请权限,获取权限后,商户需在基础支付下单接口或合单支付下单接口中补充实名参数(用于校验下单传入的用户身份信息和实际支付人身份信息是否为同一实名用户),并传入家电品类能耗等级所对应的goods_tag订单优惠标识信息

1、基础支付

下单接口-V3

支持 JSAPI 支付、 APP 支付、 H5支付、小程序支付

服务商模式下单接口:JSAPI/小程序下单

直连商户下单原接口:JSAPI/小程序下单

注意:

V3版本下单接口上传的指定身份信息相关字段,以明文形式传入即可,无需加密。

请求参数

参数名

变量

类型[长度限制]

必填

描述

支付者

payer

object

支付者信息。

属性

请求示例

1{
2"payer": {
3    "identity": {
4      "name": "周星星",
5      "number": "43102119910910512X",
6      "type": "IDCARD"
7    }
8  }
9}
10

下单接口-V2

服务商模式下单原接口:统一下单

直连商户下单原接口:统一下单

注意:

  • 支持JSAPI 支付、 APP 支付、 H5支付、小程序支付,接口url是同一个,只需在trade_type传入不同的值,具体可参考交易类型trade_type

  • 统一下单接口上传的指定身份信息相关字段,以明文形式传入即可,无需加密。

请求参数

参数名

变量

类型[长度限制]

必填

描述

证件类型

user_type

string[32]

证件类型,枚举值:
IDCARD:身份证
HONGKONG_MACAO:港澳回乡

HONGKONG_MACAO_RESIDEN
T:港澳居住证
TAIWAN_RESIDENT:台湾居住证FOREIGN_RESIDENT:外国人永居证
OVERSEA_PASSPORT:护照

示例值:IDCARD

证件号

user_creid

string[32]

证件号,如身份证号。

示例值:43102119910910512X

姓名

user_truename

string[64]

证件姓名。

示例值:周星星

请求示例

1<user_type>IDCARD</user_type>
2<user_creid>43102119910910512X</user_creid>
3<user_truename>周星星</user_truename>

2、合单支付

支持 JSAPI 支付、 APP 支付、 H5支付、小程序支付

服务商合单支付下单原接口:合单下单

直连商户合单支付下单原接口:合单下单

注意:

请求参数

参数名

变量

类型[长度限制]

必填

描述

合单支付者

combine_payer_info

object

支付者信息。

属性

请求示例

1{
2"payer": {
3    "identity": {
4      "name": "F1oNHN6E/UWgSX8R1C/05aaxxccTruciMeeuwhrfuhewPYhrazio9TbqFIJlwh7ICEAsSDDIQ+bTKfQ3mBM/cMxXgfsdgsgswXP8X2QoKAEqT+w/xeouju+/IN5HCLDZni40R3b0OrBtn861VoZ24XpovpnIDTfkEIsQAZz2oU4EPyJIzOPT35w93X3kAcDdF8J4dX4RY8Y/L6llgV85KrxU0q1sR0NkwrY+KJo8Gl7tfLG2ErZgPHrvsbStsplftoZS3YLhXPD2x+Uj0KTTG82Rrx/ZFLzimLx2xCSq5q1LkEAGYnyzeUwpl/f8oe9g4cUyih6eeyVzE7i1cOIg==",
5      "number": "BzgElx75mHaxcxcfebwOX0Pasdsadafdg6CyzNk3w+uCk+PN4nON2U1GM1p/mrBUQLL/ALg9zfGWfqffsfsAQkaQgT/AKZkP2zWQaJRP8Hxg6lfBTIZkDhS/NNlPr6PJ5XFI+Xd2mRtjDZT5EfmVuQfuJElozBxwbMcZV0rvJdz5Q8wN6eEw8q9lUemBrEdq6UOLX6rmgrAk12YBe05+DMN2bMJkOWCskOY+kmQAPeOvAc6auDzWai37te24R6NWwm+a85U/R8vKDKN65YY7Bs8G6uAt19CA9+0jSP1geYTJaHHJ1GOZ5APKh8KK7H5Frh0Vw==",
6      "type": "IDCARD"
7    }
8  }
9}
10