添加微信支付实名验证接口 by Copilot · Pull Request #3814 · binarywang/WxJava · GitHub

根据官方文档 https://pay.wechatpay.cn/doc/v2/merchant/4011987607 添加实名验证相关接口，用于查询用户实名认证状态。

新增组件

Bean类: RealNameRequest / RealNameResult - 请求响应对象，包含认证状态、认证信息和引导链接
服务接口: RealNameService - 查询用户实名认证状态
服务实现: RealNameServiceImpl - 调用 /userinfo/realnameauth/query 接口，需要商户证书
文档: REAL_NAME_USAGE.md - 完整使用说明

集成方式

在 WxPayService 中添加 getRealNameService() 方法，在 BaseWxPayServiceImpl 中自动初始化服务实例。

使用示例

// 简化调用
RealNameResult result = wxPayService.getRealNameService()
    .queryRealName("oUpF8uMuAJO_M2pxb1Q9zNjWeS6o");

if ("Y".equals(result.getIsCertified())) {
    // 已实名，可获取加密的认证信息
    String certInfo = result.getCertInfo();
} else {
    // 未实名，引导用户完成认证
    String guideUrl = result.getGuideUrl();
}

返回字段说明：

is_certified: 认证状态 (Y/N)
cert_info: 实名信息（加密，仅已认证时返回）
guide_url: 认证引导链接（仅未认证时返回）

Warning

Firewall rules blocked me from connecting to one or more addresses (expand for details)

I tried to connect to the following addresses, but was blocked by firewall rules:

pay.wechatpay.cn
- Triggering command: /usr/bin/curl curl -s REDACTED (dns block)

If you need me to access, download, or install something from one of these locations, you can either:

Configure Actions setup steps to set up my environment, which run before the firewall is enabled
Add the appropriate URLs or hosts to the custom allowlist in this repository's Copilot coding agent settings (admins only)

Original prompt

This section details on the original issue you should resolve

<issue_title>添加微信支付的实名验证相关的接口</issue_title>
<issue_description>### 简要描述
微信支付的实名验证相关的接口没有找到，是否能添加？

官方文档地址

请提供所需功能对应的微信官方文档地址以便进行确认。
https://pay.wechatpay.cn/doc/v2/merchant/4011987607</issue_description>

Comments on the Issue (you are @copilot in this section)

Custom agent used: 全部用中文
需要用中文，包括PR标题和分析总结过程

Fixes 添加微信支付的实名验证相关的接口 #3804

💬 We'd love your input! Share your thoughts on Copilot coding agent in our 2 minute survey.

Co-authored-by: binarywang <1343140+binarywang@users.noreply.github.com>

Pull request overview

本 PR 实现了微信支付实名验证相关接口，根据微信官方文档添加查询用户实名认证状态的功能。

主要变更：

新增 RealNameService 接口和 RealNameServiceImpl 实现类，提供查询用户实名认证状态的功能
新增 RealNameRequest 和 RealNameResult Bean 类，用于封装请求和响应数据
在 WxPayService 中集成实名验证服务，通过 getRealNameService() 方法提供访问入口

Reviewed changes

Copilot reviewed 8 out of 8 changed files in this pull request and generated 5 comments.

Show a summary per file

File	Description
weixin-java-pay/src/main/java/com/github/binarywang/wxpay/bean/realname/RealNameRequest.java	新增实名验证请求对象，继承 BaseWxPayRequest，包含必填的 openid 字段
weixin-java-pay/src/main/java/com/github/binarywang/wxpay/bean/realname/RealNameResult.java	新增实名验证响应对象，继承 BaseWxPayResult，包含认证状态、认证信息和引导链接字段
weixin-java-pay/src/main/java/com/github/binarywang/wxpay/service/RealNameService.java	新增实名验证服务接口，定义查询实名认证信息的方法（完整版本和简化版本）
weixin-java-pay/src/main/java/com/github/binarywang/wxpay/service/impl/RealNameServiceImpl.java	实现实名验证服务，调用微信支付 API 并处理响应，使用商户证书进行安全请求
weixin-java-pay/src/main/java/com/github/binarywang/wxpay/service/WxPayService.java	在主服务接口中添加 getRealNameService() 方法，提供实名验证服务访问入口
weixin-java-pay/src/main/java/com/github/binarywang/wxpay/service/impl/BaseWxPayServiceImpl.java	在基础实现类中初始化 RealNameService 实例，确保服务自动可用
weixin-java-pay/src/test/java/com/github/binarywang/wxpay/service/impl/RealNameServiceImplTest.java	新增测试类，包含完整和简化两种调用方式的测试用例
weixin-java-pay/REAL_NAME_USAGE.md	新增详细的使用文档，包含接口说明、使用示例、注意事项和错误处理指南

在 BaseWxPayServiceImpl 中的 realNameService 字段初始化后存在多余的空行。为了保持代码风格一致性，应该删除第 142 行的空行，使其与其他服务字段的格式保持一致。

Suggested change

在 WxPayService 接口中的 getRealNameService() 方法后存在多余的空行。为了保持代码风格一致性，应该删除第 1716 行的空行，使其与其他服务方法的格式保持一致。

Suggested change

This method overrides BaseWxPayResult.canEqual; it is advisable to add an Override annotation.

This method overrides BaseWxPayRequest.canEqual; it is advisable to add an Override annotation.

This method overrides WxPayService.getRealNameService; it is advisable to add an Override annotation.

Suggested change

      
              @Getter
          
              private final RealNameService realNameService = new RealNameServiceImpl(this);
          
              @Getter
          
              private final MiPayService miPayService = new MiPayServiceImpl(this);
          
              private final RealNameService realNameService = new RealNameServiceImpl(this);
          
              @Getter
          
              private final MiPayService miPayService = new MiPayServiceImpl(this);
          
              @Override
          
              public RealNameService getRealNameService() {
          
                return this.realNameService;
          
              }

Initial plan

bf4afdc

Copilot AI assigned Copilot and binarywang Dec 19, 2025

Copilot started work on behalf of binarywang December 19, 2025 17:18 View session

Copilot AI and others added 3 commits December 19, 2025 17:26

添加微信支付实名验证相关接口的核心实现

e546bb3

Co-authored-by: binarywang <1343140+binarywang@users.noreply.github.com>

添加实名验证服务的测试类

5f96272

Co-authored-by: binarywang <1343140+binarywang@users.noreply.github.com>

添加实名验证接口使用文档

4ff3f1e

Co-authored-by: binarywang <1343140+binarywang@users.noreply.github.com>

Copilot AI changed the title [WIP] Add WeChat payment real-name validation API 添加微信支付实名验证接口 Dec 19, 2025

Copilot AI requested a review from binarywang December 19, 2025 17:34

Copilot finished work on behalf of binarywang December 19, 2025 17:34

Merge branch 'develop' into copilot/add-wechat-payment-validation-api

030c6f9

binarywang marked this pull request as ready for review December 20, 2025 09:23

Copilot AI review requested due to automatic review settings December 20, 2025 09:23

Copilot started reviewing on behalf of binarywang December 20, 2025 09:23 View session

binarywang merged commit 3b8d0a8 into develop Dec 20, 2025
4 of 5 checks passed

binarywang deleted the copilot/add-wechat-payment-validation-api branch December 20, 2025 09:24

binarywang added this to the 4.8.0 milestone Dec 20, 2025

Copilot AI reviewed Dec 20, 2025

View reviewed changes

Copilot AI added a commit that referenced this pull request Dec 21, 2025

🆕 #3814 【微信支付】增加实名验证的接口

7ba7957

+               * @author <a href="https://github.com/binarywang">Binary Wang</a>
+               */
+              @Data
+              @EqualsAndHashCode(callSuper = true)

+               * @author <a href="https://github.com/binarywang">Binary Wang</a>
+               */
+              @Data
+              @EqualsAndHashCode(callSuper = true)

添加微信支付实名验证接口 by Copilot · Pull Request #3814 · binarywang/WxJava · GitHub

Uh oh!

添加微信支付实名验证接口 - #3814

添加微信支付实名验证接口#3814
binarywang merged 5 commits into
developfrom
copilot/add-wechat-payment-validation-api

Copilot AI commented Dec 19, 2025 •
edited
Loading

Uh oh!

Uh oh!

Uh oh!

Copilot AI left a comment

Uh oh!

Copilot AI Dec 20, 2025

Uh oh!

Copilot AI Dec 20, 2025

Uh oh!

Copilot AI Dec 20, 2025

Uh oh!

Copilot AI Dec 20, 2025

Uh oh!

Copilot AI Dec 20, 2025

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants


		@Getter
		private final RealNameService realNameService = new RealNameServiceImpl(this);

+                 * @return the real name service
+                 */
+                RealNameService getRealNameService();

添加微信支付实名验证接口 by Copilot · Pull Request #3814 · binarywang/WxJava · GitHub

Uh oh!

添加微信支付实名验证接口 - #3814

添加微信支付实名验证接口#3814binarywang merged 5 commits intodevelopbinarywang/WxJava:developfrom copilot/add-wechat-payment-validation-apibinarywang/WxJava:copilot/add-wechat-payment-validation-apiCopy head branch name to clipboard

Conversation

Copilot AI commented Dec 19, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

新增组件

集成方式

使用示例

I tried to connect to the following addresses, but was blocked by firewall rules:

官方文档地址

Comments on the Issue (you are @copilot in this section)

Uh oh!

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Reviewed changes

Uh oh!

Copilot AI Dec 20, 2025

Choose a reason for hiding this comment

Uh oh!

Copilot AI Dec 20, 2025

Choose a reason for hiding this comment

Uh oh!

Copilot AI Dec 20, 2025

Choose a reason for hiding this comment

Uh oh!

Copilot AI Dec 20, 2025

Choose a reason for hiding this comment

Uh oh!

Copilot AI Dec 20, 2025

Choose a reason for hiding this comment

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

添加微信支付实名验证接口#3814
binarywang merged 5 commits into
developfrom
copilot/add-wechat-payment-validation-api

Copilot AI commented Dec 19, 2025 •
edited
Loading