业务示例代码

1package com.java.partner;
2
3import com.java.demo.CheckSubMchStatus; // https://pay.weixin.qq.com/doc/v3/partner/4015792561
4import com.java.demo.CheckSubMchStatus.CheckSubMchStatusRequest;
5import com.java.demo.CheckSubMchStatus.CheckSubMchStatusResponse;
6import com.java.demo.CheckSubMchStatus.DigitalTaxAbilityInfo;
7import com.java.demo.CheckSubMchStatus.DigitalTaxApplyStatus;
8import com.java.demo.CheckSubMchStatus.DigitalTaxBillingPersonInfo;
9import com.java.demo.CheckSubMchStatus.DigitalTaxMode;
10import com.java.demo.CheckSubMchStatus.ThirdMode;
11import com.java.demo.CheckSubMchStatus.ThirdModeStatus;
12import com.java.demo.GetSpInviteUrl; // https://pay.weixin.qq.com/doc/v3/partner/4015941495
13import com.java.demo.GetSpInviteUrl.FapiaoAbilityType;
14import com.java.demo.GetSpInviteUrl.GetSpInviteUrlRequest;
15import com.java.demo.GetSpInviteUrl.GetSpInviteUrlResp;
16import com.java.demo.GetSpInviteUrl.InviteOperationType;
17import com.java.demo.GetSpInviteUrl.InvoiceMode;
18import com.java.demo.ListSpInviteMchInfo;  // https://pay.weixin.qq.com/doc/v3/partner/4015941524
19import com.java.demo.ListSpInviteMchInfo.ListSpInviteMchInfoRequest;
20import com.java.demo.ListSpInviteMchInfo.ListSpInviteMchInfoResp;
21import com.java.demo.ListSpInviteMchInfo.MchInviteResultInfo;
22import com.java.demo.ListSpInviteMchInfo.MchInviteStatus;
23import com.java.utils.WXPayUtility;
24import java.time.LocalDateTime;
25import java.time.ZoneId;
26import java.time.format.DateTimeFormatter;
27import java.util.ArrayList;
28import java.util.List;
29import java.util.Objects;
30
31public class InviteMerchantDemo {
32
33    public static void main(String[] args) {
34        // TODO: 请准备商户开发必要参数，参考：https://pay.weixin.qq.com/doc/v3/partner/4013080340
35        GetSpInviteUrl getInvite = new GetSpInviteUrl(
36                "19xxxxxxxx",
37                // 商户号，是由微信支付系统生成并分配给每个商户的唯一标识符，商户号获取方式参考 https://pay.weixin.qq.com/doc/v3/partner/4013080340
38                "1DDE55AD98Exxxxxxxxxx", // 商户API证书序列号，如何获取请参考 https://pay.weixin.qq.com/doc/v3/partner/4013058924
39                "/path/to/apiclient_key.pem", // 商户API证书私钥文件路径，本地文件路径
40                "PUB_KEY_ID_xxxxxxxxxxxxx", // 微信支付公钥ID，如何获取请参考 https://pay.weixin.qq.com/doc/v3/partner/4013038589
41                "/path/to/wxp_pub.pem" // 微信支付公钥文件路径，本地文件路径
42        );
43
44        ListSpInviteMchInfo listSpInviteMchInfo = new ListSpInviteMchInfo(
45                "19xxxxxxxx",
46                // 商户号，是由微信支付系统生成并分配给每个商户的唯一标识符，商户号获取方式参考 https://pay.weixin.qq.com/doc/v3/partner/4013080340
47                "1DDE55AD98Exxxxxxxxxx", // 商户API证书序列号，如何获取请参考 https://pay.weixin.qq.com/doc/v3/partner/4013058924
48                "/path/to/apiclient_key.pem", // 商户API证书私钥文件路径，本地文件路径
49                "PUB_KEY_ID_xxxxxxxxxxxxx", // 微信支付公钥ID，如何获取请参考 https://pay.weixin.qq.com/doc/v3/partner/4013038589
50                "/path/to/wxp_pub.pem" // 微信支付公钥文件路径，本地文件路径
51        );
52
53        CheckSubMchStatus checkSubMchStatus = new CheckSubMchStatus(
54                "19xxxxxxxx",
55                // 商户号，是由微信支付系统生成并分配给每个商户的唯一标识符，商户号获取方式参考 https://pay.weixin.qq.com/doc/v3/partner/4013080340
56                "1DDE55AD98Exxxxxxxxxx", // 商户API证书序列号，如何获取请参考 https://pay.weixin.qq.com/doc/v3/partner/4013058924
57                "/path/to/apiclient_key.pem", // 商户API证书私钥文件路径，本地文件路径
58                "PUB_KEY_ID_xxxxxxxxxxxxx", // 微信支付公钥ID，如何获取请参考 https://pay.weixin.qq.com/doc/v3/partner/4013038589
59                "/path/to/wxp_pub.pem" // 微信支付公钥文件路径，本地文件路径
60        );
61
62        GetSpInviteUrlRequest inviteRequest = new GetSpInviteUrlRequest();
63        inviteRequest.operationType = InviteOperationType.AUTH_BINDING;
64        inviteRequest.fapiaoMode = new ArrayList<>();
65        {
66            inviteRequest.fapiaoMode.add(InvoiceMode.THIRD_OR_SELF_FAPIAO);
67        }
68        inviteRequest.fapiaoAbilityTypeList = new ArrayList<>();
69        {
70            inviteRequest.fapiaoAbilityTypeList.add(FapiaoAbilityType.BASE_ABILITY);
71        }
72        // 服务商设置标识此次邀请链接生成的渠道
73        inviteRequest.inviteChannel = "miniprogram";
74        // 服务商设置标识此次邀请链接生成的操作人员
75        inviteRequest.operateUser = "mI7HGEJ4Q2B91IGjHZu/Gthm87Szv0MK2AoC0/3ZMDgltMtdoY6O0qZ4F1iXiwCuqkkBe+9M4ggvdzRVVVB9s+zLEQ8" +
76        	"nv74vsgl77MZx14nd5obtCcfAvPfDJob3oG7FqlThmYKJqjiOwBvvQse7p9R8onj/POzSrbM8re8ZYGp4LcehXopTLdk2ZVWRv8bnJgKZeY4vpMmq4xuRTYk6xNXvowBBKLu4oaNFNdBO3fip1a1rFW0vRw==";
77        inviteRequest.inviteCode = "code_20200101_123";
78        // 子商户号非必填，如果填入表示这个链接只能邀请这个商户号，如果未填表示商户扫码后，需要手动输入商户号或者微信支付订单号来进行开通
79        inviteRequest.subMchid = "19998278783";
80
81        ListSpInviteMchInfoRequest listSpInviteMchInfoRequest = new ListSpInviteMchInfoRequest();
82        final DateTimeFormatter dateTimeFormatter = DateTimeFormatter.ISO_OFFSET_DATE_TIME.withZone(
83                ZoneId.of("Asia/Shanghai"));
84        LocalDateTime now = LocalDateTime.now();
85        // 定时查询当前时间过去10分钟之内邀请的商户信息
86        listSpInviteMchInfoRequest.queryTimeStart = dateTimeFormatter.format(now.minusMinutes(10).atOffset(ZoneOffset.ofHours(8)));
87        // 查询时间间隔不能查过7天
88        listSpInviteMchInfoRequest.queryTimeEnd = dateTimeFormatter.format(now.atOffset(ZoneOffset.ofHours(8)));
89        // 查询开始的起始位置
90        listSpInviteMchInfoRequest.offset = 0L;
91        listSpInviteMchInfoRequest.limit = 10L;
92        // 与获取邀请链接时传入的inviteCode保持一致
93        listSpInviteMchInfoRequest.inviteCode = "code_20200101_123";
94        // 只有邀请成功的商户信息，才会同步返回商户号
95        listSpInviteMchInfoRequest.mchInviteStatus = MchInviteStatus.MCH_INVITE_SUCC;
96
97        try {
98            GetSpInviteUrlResp response = getInvite.run(inviteRequest);
99
100            //将inviteUrl转换为二维码，商户通过微信扫码后，
101            //可以跳转到微信支付服务商电子发票能力开通页面，引导用户完成授权开通服务商电子发票能力。
102            System.out.println("inviteUrl: " + response.inviteUrl);
103            //通过指引https://developers.weixin.qq.com/miniprogram/dev/api/navigate/wx.navigateToMiniProgram.html，使用miniprogramAppid，miniprogramPath
104            //引导商户跳转到微信支付服务商电子发票能力开通页面，完成授权开通服务商电子发票能力。
105            System.out.println("miniprogramAppid: " + response.miniprogramAppid);
106            System.out.println("miniprogramPath: " + response.miniprogramPath);
107
108            // 等待商户操作完成开通
109            // 如果服务商不知晓邀请商户的商户号，可以通过定时任务获取邀请确认授权成功的商户的商户号信息
110            ListSpInviteMchInfoResp listSpInviteMchInfoResp = listSpInviteMchInfo.run(listSpInviteMchInfoRequest);
111            List<MchInviteResultInfo> mchInviteResultList = listSpInviteMchInfoResp.mchInviteResultList;
112            for (MchInviteResultInfo mchInviteResultInfo : mchInviteResultList) {
113                if (mchInviteResultInfo.mchInviteStatus == MchInviteStatus.MCH_INVITE_SUCC) {
114                    // 如果是邀请成功状态的商户，可以获取到商户的商户号，用于检查商户的开通授权状态
115                    String subMchid = mchInviteResultInfo.subMchid;
116
117                    CheckSubMchStatusRequest checkSubMchStatusRequest = new CheckSubMchStatusRequest();
118                    checkSubMchStatusRequest.subMchid = subMchid;
119                    
120                    // 服务商获取商户的商户号信息后，请求【检查子商户开票功能状态】（https://pay.weixin.qq.com/doc/v3/partner/4015792561）接口获取商户开通状态
121                    CheckSubMchStatusResponse checkSubMchStatusResponse = checkSubMchStatus.run(
122                            checkSubMchStatusRequest);
123                    if (subMchid.equals(checkSubMchStatusResponse.subMchid)) {
124                        ThirdMode thirdMode = checkSubMchStatusResponse.thirdMode;
125                        DigitalTaxMode digitalTaxMode = checkSubMchStatusResponse.digitalTaxMode;
126                        // 【获取邀请开通的商户信息】（https://pay.weixin.qq.com/doc/v3/partner/4015941524）邀请开通 【THIRD_OR_SELF_FAPIAO:第三方/自建发票】。检查该模式开通状态
127                        if (Objects.nonNull(thirdMode)) {
128                            ThirdModeStatus status = thirdMode.status;
129                        }
130
131                        // 获取邀请开通的商户信息】（https://pay.weixin.qq.com/doc/v3/partner/4015941524）邀请开通 【TENCENT_DIGITAL_TAX:腾讯数电发票】。检查该模式开通状态
132                        if (Objects.nonNull(digitalTaxMode)) {
133                            // 数电发票接入状态，根据【检查子商户开票功能状态】（https://pay.weixin.qq.com/doc/v3/partner/4015792561）状态描述判断用户开通的情况
134                            DigitalTaxApplyStatus digitalTaxApplyStatus = digitalTaxMode.status;
135                            List<DigitalTaxBillingPersonInfo> billingPersonInfoList = digitalTaxMode.billingPersonInfo;
136                            for (DigitalTaxBillingPersonInfo digitalTaxBillingPersonInfo : billingPersonInfoList) {
137                                // 商户在乐企平台上设置了开票员信息，才会返回对应开票员的开票员ID，用于开具数电发票接口，请求入参
138                                String billingPersonId = digitalTaxBillingPersonInfo.id;
139                            }
140                            // 商户完成所有操作后，完成接入腾讯数电后的时间
141                            String accessTime = digitalTaxMode.accessTime;
142                            String expiredTime = digitalTaxMode.expiredTime;
143                            String accessFailReason = digitalTaxMode.accessFailReason;
144                            List<DigitalTaxAbilityInfo> abilityInfo = digitalTaxMode.abilityInfo;
145                        }
146                    }
147                } else {
148                    // 如果是邀请失败状态的商户，获取商户的商户名称，以及邀请开通失败的原因。
149                    // 根据开通小程序页面下的帮助指引，指导商户解决问题重试开通授权流程
150                    String epName = mchInviteResultInfo.epName;
151                    String inviteFailedReason = mchInviteResultInfo.inviteFailedReason;
152                }
153            }
154        } catch (WXPayUtility.ApiException e) {
155            // 处理异常处理逻辑
156            if (e.getErrorCode().equals("SYSTEM_ERROR")) {
157                // 错误：系统错误
158                // 解决方式：稍后重试
159                // 描述：微信支付系统失败，建议等1分钟后再重试
160            } else if (e.getErrorCode().equals("FREQUENCY_LIMITED")) {
161                // 错误：限频报错
162                // 解决方式：稍后重试
163                // 描述： 接口频率限制，一定要原单重试，建议等1分钟后再重试
164            } else if (e.getErrorCode().equals("ERROR")) {
165                // 错误：系统错误
166                // 解决方式：系统繁忙，请稍后重试
167                // 描述：微信支付系统失败，建议等1分钟后再重试
168            } else if (e.getErrorCode().equals("NO_AUTH")) {
169                // 错误：服务商无权限
170                // 解决方式：根据具体message，查看指引解决问题
171                // 描述：
172                // - 商户无权限访问，请确认是否已开通相关权限
173                // - 服务商无电子发票权限，请联系支持开通服务商电子发票
174                // - 乐企数电安全校验时间已过期，请登录电子税局重新设置数电安全校验时间
175            } else if (e.getErrorCode().equals("SIGN_ERROR")) {
176                // 错误：签名错误
177                // 解决方式：检查平台商户证书序列号，证书私钥文件，公钥ID，公钥文件，同时确认下签名过程是不是按照微信支付的签名方式
178                // 描述：签名报错，需要确认签名材料和签名流程是否正确
179            } else if (e.getErrorCode().equals("PARAM_ERROR")) {
180                // 错误：参数错误
181                // 解决方式：按照报错返回的message，重新输入请求参数
182                // 描述：参数的类型，长度，或者必填选项没有填写等
183            } else if (e.getErrorCode().equals("INVALID_REQUEST")) {
184                // 错误：请求非法，请求参数正确，但是不符合业务规则
185                // 解决方式：根据具体message查看具体哪里不符合业务规则，如果可以修改参数达到符合业务规则的修改请求符合业务规则之后重试
186                // 描述：不符合业务规则的场景如：
187                // - 查询起止时间间隔不能大于7天
188                // - 查询起始时间不能大于查询结束时间
189            } else {
190                // 其他类型错误：稍等一会后原单重试
191            }
192        }
193    }
194}

1package com.java.partner;
2
3import com.java.demo.CreateFapiaoCardTemplate;  // https://pay.weixin.qq.com/doc/v3/partner/4015792562
4import com.java.demo.CreateFapiaoCardTemplate.CardTemplateInfo;
5import com.java.demo.CreateFapiaoCardTemplate.CreateFapiaoCardTemplateRequest;
6import com.java.demo.CreateFapiaoCardTemplate.CustomCell;
7import com.java.demo.CreateFapiaoCardTemplate.FapiaoCardTemplateEntity;
8import com.java.demo.UpdateDevelopmentConfig; // https://pay.weixin.qq.com/doc/v3/partner/4015792563
9import com.java.demo.UpdateDevelopmentConfig.DevelopmentConfigEntity;
10import com.java.demo.UpdateDevelopmentConfig.UpdateDevelopmentConfigRequest;
11import com.java.utils.WXPayUtility;
12
13public class SetMerchantInvoiceConfigDemo {
14
15    public static void main(String[] args) {
16        // TODO: 请准备商户开发必要参数，参考：https://pay.weixin.qq.com/doc/v3/partner/4013080340
17        CreateFapiaoCardTemplate createFapiaoCardTemplate = new CreateFapiaoCardTemplate(
18                "19xxxxxxxx",
19                // 商户号，是由微信支付系统生成并分配给每个商户的唯一标识符，商户号获取方式参考 https://pay.weixin.qq.com/doc/v3/partner/4013080340
20                "1DDE55AD98Exxxxxxxxxx",
21                // 商户API证书序列号，如何获取请参考 https://pay.weixin.qq.com/doc/v3/partner/4013058924
22                "/path/to/apiclient_key.pem",     // 商户API证书私钥文件路径，本地文件路径
23                "PUB_KEY_ID_xxxxxxxxxxxxx",      // 微信支付公钥ID，如何获取请参考 https://pay.weixin.qq.com/doc/v3/partner/4013038589
24                "/path/to/wxp_pub.pem"           // 微信支付公钥文件路径，本地文件路径
25        );
26
27        UpdateDevelopmentConfig updateDevelopmentConfig = new UpdateDevelopmentConfig(
28                "19xxxxxxxx",
29                // 商户号，是由微信支付系统生成并分配给每个商户的唯一标识符，商户号获取方式参考 https://pay.weixin.qq.com/doc/v3/partner/4013080340
30                "1DDE55AD98Exxxxxxxxxx",
31                // 商户API证书序列号，如何获取请参考 https://pay.weixin.qq.com/doc/v3/partner/4013058924
32                "/path/to/apiclient_key.pem",     // 商户API证书私钥文件路径，本地文件路径
33                "PUB_KEY_ID_xxxxxxxxxxxxx",      // 微信支付公钥ID，如何获取请参考 https://pay.weixin.qq.com/doc/v3/partner/4013038589
34                "/path/to/wxp_pub.pem"           // 微信支付公钥文件路径，本地文件路径
35        );
36
37        CreateFapiaoCardTemplateRequest createFapiaoCardTemplateRequest = new CreateFapiaoCardTemplateRequest();
38        createFapiaoCardTemplateRequest.subMchid = "1900000109";
39        createFapiaoCardTemplateRequest.cardAppid = "wxb1170446a4c0a5a2";
40        createFapiaoCardTemplateRequest.cardTemplateInformation = new CardTemplateInfo();
41        // 具体字段展示对应卡包展示内容在代码后有示例。
42        createFapiaoCardTemplateRequest.cardTemplateInformation.payeeName = "某公司";
43        createFapiaoCardTemplateRequest.cardTemplateInformation.logoUrl = "http://mmbiz.qpic.cn/mmbiz/iaL1LJM1mF9aRKPZJkmG8xXhiaHqkKSVMMWeN3hLut7X7hicFNjakmxibMLGWpXrEXB33367o7zHN0CwngnQY7zb7g/0";
44        createFapiaoCardTemplateRequest.cardTemplateInformation.customCell = new CustomCell();
45        createFapiaoCardTemplateRequest.cardTemplateInformation.customCell.words = "电子发票";
46        createFapiaoCardTemplateRequest.cardTemplateInformation.customCell.description = "查看发票";
47        // 点击卡券详情页自定义cell位后跳转的页面链接，用户跳转时会自动在链接后加上参数encrypt_code与card_id，商户需要调用code解码接口解码encrypt_code得到真实的code
48        // https://developers.weixin.qq.com/doc/service/guide/product/card/Redeeming_a_coupon_voucher_or_card.html#5 2.2节 Code解码接口 解码encrypt_code
49        // 通过【查询电子发票】接口，获取card_information.card_code 与 解密的Code进行比对，确认是否为该商户的电子发票。
50        createFapiaoCardTemplateRequest.cardTemplateInformation.customCell.jumpUrl = "http://www.qq.com";
51        createFapiaoCardTemplateRequest.cardTemplateInformation.customCell.miniprogramUserName = "gh_86a091e50ad4@app";
52        createFapiaoCardTemplateRequest.cardTemplateInformation.customCell.miniprogramPath = "pages/xxxPage";
53
54        UpdateDevelopmentConfigRequest updateDevelopmentConfigRequest = new UpdateDevelopmentConfigRequest();
55        // 设置服务商的可以接受回调请求的地址，回调设置会校验接口是否能够正确返回http code 200，如果无法返回200，会返回错误。
56        updateDevelopmentConfigRequest.callbackUrl = "https://pay.weixin.qq.com/callback";
57        updateDevelopmentConfigRequest.subMchCode = "1900000109";
58        updateDevelopmentConfigRequest.showFapiaoCell = false;
59        updateDevelopmentConfigRequest.supportVatFapiao = false;
60
61        try {
62            FapiaoCardTemplateEntity fapiaoCardTemplateEntity = createFapiaoCardTemplate.run(
63                    createFapiaoCardTemplateRequest);
64            System.out.println("card_appid:" + fapiaoCardTemplateEntity.cardAppid);
65            // 用于请求申请开具电子发票时，卡券模板ID参数
66            System.out.println("card_id:" + fapiaoCardTemplateEntity.cardId);
67
68            DevelopmentConfigEntity developmentConfigEntity = updateDevelopmentConfig.run(
69                    updateDevelopmentConfigRequest);
70            // 服务商申请接受回调请求的地址
71            System.out.println("callback_url:" + developmentConfigEntity.callbackUrl);
72            // 属于商户的微信支付账单凭证，是否展示开发票入口
73            System.out.println("show_fapiao_cell:" + developmentConfigEntity.showFapiaoCell);
74            // 商户是否支持开具增值税专用发票。如果设置为ture，针对商户所有的开票申请，填写抬头页面是否展示选择电子发票类型选项
75            System.out.println("support_vat_fapiao:" + developmentConfigEntity.supportVatFapiao);
76        } catch (WXPayUtility.ApiException e) {
77            // 处理异常处理逻辑
78            if (e.getErrorCode().equals("SYSTEM_ERROR")) {
79                // 错误：系统错误
80                // 解决方式：稍后重试
81                // 描述：微信支付系统失败，建议等1分钟后再重试
82            } else if (e.getErrorCode().equals("FREQUENCY_LIMITED")) {
83                // 错误：限频报错
84                // 解决方式：稍后重试
85                // 描述： 接口频率限制，一定要原单重试，建议等1分钟后再重试
86            } else if (e.getErrorCode().equals("ERROR")) {
87                // 错误：系统错误
88                // 解决方式：系统繁忙，请稍后重试
89                // 描述：微信支付系统失败，建议等1分钟后再重试
90            } else if (e.getErrorCode().equals("NO_AUTH")) {
91                // 错误：服务商无权限
92                // 解决方式：开通微信支付电子发票服务商权限，并且检查商户是否接受邀请开通授权微信支付电子发票能力，等1分钟后重试。
93                // 描述：商户无权限访问，请确认是否已开通相关权限
94            } else if (e.getErrorCode().equals("SIGN_ERROR")) {
95                // 错误：签名错误
96                // 解决方式：检查平台商户证书序列号，证书私钥文件，公钥ID，公钥文件，同时确认下签名过程是不是按照微信支付的签名方式
97                // 描述：签名报错，需要确认签名材料和签名流程是否正确
98            } else if (e.getErrorCode().equals("PARAM_ERROR")) {
99                // 错误：参数错误
100                // 解决方式：按照报错返回的message，重新输入请求参数
101                // 描述：参数的类型，长度，或者必填选项没有填写等
102            } else if (e.getErrorCode().equals("INVALID_REQUEST")) {
103                // 错误：请求非法，请求参数正确，但是不符合业务规则
104                // 解决方式：根据具体message查看具体哪里不符合业务规则，如果可以修改参数达到符合业务规则的修改请求符合业务规则之后重试
105                // 描述：不符合业务规则的场景如：
106                // - 创建发票卡券模板失败，请稍候重试
107                // - 传入的参数“点击cell位跳转的地址”以及“点击cell位跳转的小程序的用户名/页面路径”均为空（位于/body/card_template_info/custom_cell/jump_url|miniprogram_user_name|miniprogram_page_path），
108              	//   请检查参数格式是否符合要求
109            } else {
110                // 其他类型错误：稍等一会后原单重试
111            }
112        }
113    }
114}

1package com.tencent.wxpay.fapiao;
2
3import com.google.gson.annotations.SerializedName;
4import com.tencent.wxpay.utils.WXPayUtility;
5import com.tencent.wxpay.utils.WXPayUtility.Notification;
6import java.security.PublicKey;
7import okhttp3.Headers;
8import okhttp3.Response;
9
10public class UserTitleNotifyDemo {
11    // TODO: 请准备商户开发必要参数，参考：https://pay.weixin.qq.com/doc/v3/partner/4013080340
12    // 商户号，是由微信支付系统生成并分配给每个商户的唯一标识符，商户号获取方式参考
13    // https://pay.weixin.qq.com/doc/v3/merchant/4013070756
14    private static String mchid = "19xxxxxxxx";
15    // 商户API证书序列号，如何获取请参考 https://pay.weixin.qq.com/doc/v3/partner/4013080340
16    private static String certificateSerialNo = "1DDE55AD98Exxxxxxxxxx";
17    // 商户API证书私钥文件路径，本地文件路径
18    private static String privateKeyFilePath = "/path/to/apiclient_key.pem";
19    // 微信支付公钥ID，如何获取请参考 https://pay.weixin.qq.com/doc/v3/partner/4013080340
20    private static String wechatPayPublicKeyId = "PUB_KEY_ID_xxxxxxxxxxxxx";
21    // 微信支付公钥文件路径，本地文件路径
22    private static String wechatPayPublicKeyFilePath = "/path/to/wxp_pub.pem";
23    // 商户APIv3密钥，如何获取请参考 https://pay.weixin.qq.com/doc/v3/partner/4013080340
24    private static String apiv3Key = "your apiv3 key";
25
26    public static class UserTitle {
27        @SerializedName("mchid")
28        public String mchid;
29
30        @SerializedName("sub_mchid")
31        public String subMchId;
32
33        @SerializedName("fapiao_apply_id")
34        public String fapiaoApplyId;
35
36        @SerializedName("apply_time")
37        public String applyTime;
38    }
39
40    public void userTitleNotify(Response httpResponse) {
41        String refundNotifyStr = WXPayUtility.extractBody(httpResponse); // 用户填写抬头通知的原始字符串
42        Headers headers = httpResponse.headers(); // 用户填写抬头通知的Headers
43        PublicKey wechatPayPublicKey = WXPayUtility.loadPublicKeyFromPath(wechatPayPublicKeyFilePath);
44
45        Notification notification = WXPayUtility.parseNotification(
46                apiv3Key,
47                wechatPayPublicKeyId, wechatPayPublicKey, headers,
48                refundNotifyStr);
49
50        // 解析用户填写抬头信息
51        UserTitle userTitle = WXPayUtility.fromJson(notification.getResource().getCiphertext(), UserTitle.class);
52
53        String notifyMchId = userTitle.mchid;
54        if (mchid.equals(notifyMchId)) {
55            // 用于服务商获取用户填写抬头的具体信息
56            String subMchId = userTitle.subMchId;
57            String fapiaoApplyId = userTitle.fapiaoApplyId;
58        }
59    }
60}

1package com.java.partner;
2
3import com.java.demo.GetFapiaoApplications;  // https://pay.weixin.qq.com/doc/v3/partner/4015792567
4import com.java.demo.GetFapiaoApplications.FapiaoApplicationsEntity;
5import com.java.demo.GetFapiaoApplications.FapiaoEntity;
6import com.java.demo.GetFapiaoApplications.FapiaoInfo;
7import com.java.demo.GetFapiaoApplications.GetFapiaoApplicationsRequest;
8import com.java.demo.GetFapiaoFileDownloadInfo;  // https://pay.weixin.qq.com/doc/v3/partner/4015792576
9import com.java.demo.GetFapiaoFileDownloadInfo.FapiaoDownloadInfo;
10import com.java.demo.GetFapiaoFileDownloadInfo.GetFapiaoFileDownloadInfoRequest;
11import com.java.demo.GetFapiaoFileDownloadInfo.GetFapiaoFileDownloadInfoResponse;
12import com.java.demo.GetUserTitle; // https://pay.weixin.qq.com/doc/v3/partner/4015784260
13import com.java.demo.GetUserTitle.BuyerType;
14import com.java.demo.GetUserTitle.GetUserTitleRequest;
15import com.java.demo.GetUserTitle.Scene;
16import com.java.demo.GetUserTitle.UserTitleEntity;
17import com.java.demo.IssueGeneralIndustryFapiaoApplications; // https://pay.weixin.qq.com/doc/v3/partner/4015792574
18import com.java.demo.IssueGeneralIndustryFapiaoApplications.FapiaoBillType;
19import com.java.demo.IssueGeneralIndustryFapiaoApplications.IssueGeneralFapiaoInfo;
20import com.java.demo.IssueGeneralIndustryFapiaoApplications.IssueGeneralFapiaoItem;
21import com.java.demo.IssueGeneralIndustryFapiaoApplications.IssueGeneralFapiaoRequest;
22import com.java.demo.IssueGeneralIndustryFapiaoApplications.PayChannel;
23import com.java.demo.IssueGeneralIndustryFapiaoApplications.TransactionInfo;
24import com.java.utils.WXPayUtility.ApiException;
25import java.util.ArrayList;
26import java.util.Objects;
27
28public class IssueByTransactionVoucherDemo {
29
30    public static void main(String[] args) {
31        // TODO: 请准备商户开发必要参数，参考：https://pay.weixin.qq.com/doc/v3/partner/4013080340
32        GetUserTitle getUserTitle = new GetUserTitle(
33                "19xxxxxxxx",
34                // 商户号，是由微信支付系统生成并分配给每个商户的唯一标识符，商户号获取方式参考 https://pay.weixin.qq.com/doc/v3/partner/4013080340
35                "1DDE55AD98Exxxxxxxxxx",
36                // 商户API证书序列号，如何获取请参考 https://pay.weixin.qq.com/doc/v3/partner/4013058924
37                "/path/to/apiclient_key.pem",     // 商户API证书私钥文件路径，本地文件路径
38                "PUB_KEY_ID_xxxxxxxxxxxxx",      // 微信支付公钥ID，如何获取请参考 https://pay.weixin.qq.com/doc/v3/partner/4013038589
39                "/path/to/wxp_pub.pem"           // 微信支付公钥文件路径，本地文件路径
40        );
41
42        IssueGeneralIndustryFapiaoApplications issueGeneralIndustryFapiaoApplications = new IssueGeneralIndustryFapiaoApplications(
43                "19xxxxxxxx",
44                // 商户号，是由微信支付系统生成并分配给每个商户的唯一标识符，商户号获取方式参考 https://pay.weixin.qq.com/doc/v3/partner/4013080340
45                "1DDE55AD98Exxxxxxxxxx",
46                // 商户API证书序列号，如何获取请参考 https://pay.weixin.qq.com/doc/v3/partner/4013058924
47                "/path/to/apiclient_key.pem",     // 商户API证书私钥文件路径，本地文件路径
48                "PUB_KEY_ID_xxxxxxxxxxxxx",      // 微信支付公钥ID，如何获取请参考 https://pay.weixin.qq.com/doc/v3/partner/4013038589
49                "/path/to/wxp_pub.pem"           // 微信支付公钥文件路径，本地文件路径
50        );
51
52        GetFapiaoApplications getFapiaoApplications = new GetFapiaoApplications(
53                "19xxxxxxxx",
54                // 商户号，是由微信支付系统生成并分配给每个商户的唯一标识符，商户号获取方式参考 https://pay.weixin.qq.com/doc/v3/partner/4013080340
55                "1DDE55AD98Exxxxxxxxxx",
56                // 商户API证书序列号，如何获取请参考 https://pay.weixin.qq.com/doc/v3/partner/4013058924
57                "/path/to/apiclient_key.pem",     // 商户API证书私钥文件路径，本地文件路径
58                "PUB_KEY_ID_xxxxxxxxxxxxx",      // 微信支付公钥ID，如何获取请参考 https://pay.weixin.qq.com/doc/v3/partner/4013038589
59                "/path/to/wxp_pub.pem"           // 微信支付公钥文件路径，本地文件路径
60        );
61
62        GetFapiaoFileDownloadInfo client = new GetFapiaoFileDownloadInfo(
63                "19xxxxxxxx",
64                // 商户号，是由微信支付系统生成并分配给每个商户的唯一标识符，商户号获取方式参考 https://pay.weixin.qq.com/doc/v3/partner/4013080340
65                "1DDE55AD98Exxxxxxxxxx",
66                // 商户API证书序列号，如何获取请参考 https://pay.weixin.qq.com/doc/v3/partner/4013058924
67                "/path/to/apiclient_key.pem",     // 商户API证书私钥文件路径，本地文件路径
68                "PUB_KEY_ID_xxxxxxxxxxxxx",      // 微信支付公钥ID，如何获取请参考 https://pay.weixin.qq.com/doc/v3/partner/4013038589
69                "/path/to/wxp_pub.pem"           // 微信支付公钥文件路径，本地文件路径
70        );
71
72        GetUserTitleRequest getUserTitleRequest = new GetUserTitleRequest();
73        getUserTitleRequest.subMchid = "1900000109";
74        getUserTitleRequest.scene = Scene.WITH_WECHATPAY;
75        // 通过处理用户抬头填写完成回调通知，获取此次申请的申请单号，交易凭证开票默认申请单号为此次交易的交易单号
76        getUserTitleRequest.fapiaoApplyId = "4200000444201910177461284488";
77
78        IssueGeneralFapiaoRequest issueGeneralFapiaoRequest = new IssueGeneralFapiaoRequest();
79        issueGeneralFapiaoRequest.subMchid = "1900000109";
80        issueGeneralFapiaoRequest.fapiaoApplyId = getUserTitleRequest.fapiaoApplyId;
81        issueGeneralFapiaoRequest.buyerInformation = new IssueGeneralIndustryFapiaoApplications.UserTitleEntity();
82
83        issueGeneralFapiaoRequest.fapiaoInformation = new IssueGeneralFapiaoInfo();
84        // 此次申请开票下，申请开具的一张发票的唯一标识，如果需要红冲后换开发票、开票失败后重开发票，使用相同的fapiao_apply_id，更换不同的fapiao_id即可
85        issueGeneralFapiaoRequest.fapiaoInformation.fapiaoId = "20200701123456";
86        // 申请开票的金额，支持小于本次申请开票对应的所有交易信息的交易金额之和
87        issueGeneralFapiaoRequest.fapiaoInformation.totalAmount = 1123L;
88        issueGeneralFapiaoRequest.fapiaoInformation.items = new ArrayList<>();
89        {
90            IssueGeneralFapiaoItem itemsItem = new IssueGeneralFapiaoItem();
91            itemsItem.taxCode = "3010101020203000000";
92            itemsItem.goodsName = "*xxx*服务";
93            itemsItem.specification = "米";
94            itemsItem.unit = "米";
95            itemsItem.quantity = 100000000L;
96            itemsItem.totalAmount = 429900L;
97            itemsItem.taxRate = 1300L;
98            itemsItem.discount = false;
99            itemsItem.preferentialPolicyCode = 1L;
100            issueGeneralFapiaoRequest.fapiaoInformation.items.add(itemsItem);
101        }
102        ;
103        issueGeneralFapiaoRequest.fapiaoInformation.exportBusinessPolicyCode = 1L;
104        issueGeneralFapiaoRequest.fapiaoInformation.vatRefundLevyCode = 1L;
105        issueGeneralFapiaoRequest.fapiaoInformation.billingPersonId = "128279891283";
106        issueGeneralFapiaoRequest.fapiaoInformation.billingPerson = "example_billing_person";
107        issueGeneralFapiaoRequest.fapiaoInformation.fapiaoBillType = FapiaoBillType.COMM_FAPIAO;
108
109        issueGeneralFapiaoRequest.fapiaoInformation.remark = "备注";
110
111        GetFapiaoApplicationsRequest getFapiaoApplicationsRequest = new GetFapiaoApplicationsRequest();
112        getFapiaoApplicationsRequest.fapiaoApplyId = getUserTitleRequest.fapiaoApplyId;
113        getFapiaoApplicationsRequest.subMchid = "1900000109";
114        getFapiaoApplicationsRequest.fapiaoId = issueGeneralFapiaoRequest.fapiaoInformation.fapiaoId;
115
116        GetFapiaoFileDownloadInfoRequest getFapiaoFileDownloadInfoRequest = new GetFapiaoFileDownloadInfoRequest();
117        getFapiaoFileDownloadInfoRequest.fapiaoApplyId = getUserTitleRequest.fapiaoApplyId;
118        getFapiaoFileDownloadInfoRequest.subMchid = "1900000109";
119        getFapiaoFileDownloadInfoRequest.fapiaoId = issueGeneralFapiaoRequest.fapiaoInformation.fapiaoId;
120
121        try {
122            // 获取用户填写的抬头信息，用于申请开票接口。如果返回的字段内容为空，则开票接口不用传
123            UserTitleEntity userTitleEntity = getUserTitle.run(getUserTitleRequest);
124            // 申请开票的用户，提交的留言信息
125            System.out.println("userApplyMessage:" + userTitleEntity.userApplyMessage);
126            if (userTitleEntity.type.equals(BuyerType.INDIVIDUAL)) {
127                issueGeneralFapiaoRequest.buyerInformation.type = IssueGeneralIndustryFapiaoApplications.BuyerType.INDIVIDUAL;
128            } else {
129                issueGeneralFapiaoRequest.buyerInformation.type = IssueGeneralIndustryFapiaoApplications.BuyerType.ORGANIZATION;
130            }
131            issueGeneralFapiaoRequest.buyerInformation.name = userTitleEntity.name;
132            issueGeneralFapiaoRequest.buyerInformation.taxpayerId = userTitleEntity.taxpayerId;
133            issueGeneralFapiaoRequest.buyerInformation.address = userTitleEntity.address;
134            issueGeneralFapiaoRequest.buyerInformation.telephone = userTitleEntity.telephone;
135            issueGeneralFapiaoRequest.buyerInformation.bankName = userTitleEntity.bankName;
136            issueGeneralFapiaoRequest.buyerInformation.bankAccount = userTitleEntity.bankAccount;
137            issueGeneralFapiaoRequest.buyerInformation.phone = issueGeneralIndustryFapiaoApplications.encrypt(
138                    userTitleEntity.phone);
139            issueGeneralFapiaoRequest.buyerInformation.email = issueGeneralIndustryFapiaoApplications.encrypt(
140                    userTitleEntity.email);
141            // 返回当前交易信息对应的交易金额
142            issueGeneralFapiaoRequest.buyerInformation.amount = userTitleEntity.amount;
143            if (userTitleEntity.fapiaoBillType.equals(GetUserTitle.FapiaoBillType.COMM_FAPIAO)) {
144                issueGeneralFapiaoRequest.buyerInformation.fapiaoBillType = FapiaoBillType.COMM_FAPIAO;
145            } else {
146                issueGeneralFapiaoRequest.buyerInformation.fapiaoBillType = FapiaoBillType.VAT_FAPIAO;
147            }
148
149            issueGeneralFapiaoRequest.fapiaoInformation.transactionInformation = new ArrayList<>();
150            {
151                TransactionInfo transactionInformationItem = new TransactionInfo();
152                transactionInformationItem.payChannel = PayChannel.WECHAT_PAY;
153                transactionInformationItem.transactionId = getUserTitleRequest.fapiaoApplyId;
154                transactionInformationItem.amount = userTitleEntity.amount;
155                issueGeneralFapiaoRequest.fapiaoInformation.transactionInformation.add(transactionInformationItem);
156            }
157          	;
158
159            // 服务商通过匹配交易的商品、服务内容等信息，根据税局的要求，自行选择需要调用的行业开票接口。本示例以通用行业接口为例
160            // 无返回内容 http code202即为请求成功
161            issueGeneralIndustryFapiaoApplications.run(issueGeneralFapiaoRequest);
162
163            // 申请开具通用行业数电发票
164            FapiaoApplicationsEntity fapiaoApplicationsEntity = getFapiaoApplications.run(getFapiaoApplicationsRequest);
165            String fapiaoErrorCode = "";
166            String fapiaoErrorMessage = "";
167            for (FapiaoEntity fapiaoEntity : fapiaoApplicationsEntity.fapiaoInformation) {
168                switch (fapiaoEntity.status) {
169                    case ISSUED:
170                        // 发票开具成功，可以获取蓝票信息
171                        FapiaoInfo fapiaoInfo = fapiaoEntity.blueFapiao;
172                        break;
173                    case REVERSED:
174                        // 发票已红冲，可以获取红票信息
175                        FapiaoInfo redFapiaoInfo = fapiaoEntity.redFapiao;
176                        break;
177                    case ISSUE_ACCEPTED:
178                        // 发票开票中,等待一段时间后，重试查询电子发票
179                        break;
180                    case REVERSE_ACCEPTED:
181                        // 发票红冲中，等待一段时间后，重试查询电子发票
182                        break;
183                    case ISSUE_FAILED:
184                        // 蓝票开具失败，根据错误原因，解决问题后，换fapiao_id 进行重试开票
185                        // 常见的蓝票开具失败原因如：
186                        // - 开票参数不符合。税收编码[ 1030201000000000000 ]为汇总项，不可开具，请修改后再试。
187                        // - 开票失败乐企发票开具失败：他用或联用企业开票人未授权开票，请修改后再试。或联系主管税务机关。
188                        // - 开票预扣授信额度失败，授信额度不足本次开票金额：9.71；剩余可用额度：0.00 —— 在税局重新申请额度后，换fapiao_id 重试
189                        fapiaoErrorCode = fapiaoEntity.fapiaoErrorCode;
190                        fapiaoErrorMessage = fapiaoEntity.fapiaoErrorMessage;
191                        break;
192                    case REVERSE_FAILED:
193                        // 蓝票开具失败，根据错误原因，解决问题后，直接进行重试红冲
194                        // 常见的红票开具失败原因如：
195                        // - 该发票存在进行中的红字确认单 —— 电子税局已存在处理中的红字确认单，商户登录电子税局继续红冲，或者撤销红字确认单后，再重试请求红茶
196                        fapiaoErrorCode = fapiaoEntity.fapiaoErrorCode;
197                        fapiaoErrorMessage = fapiaoEntity.fapiaoErrorMessage;
198                        break;
199                    default:
200                        break;
201                }
202            }
203            System.out.println("fapiaoErrorCode:" + fapiaoErrorCode);
204            System.out.println("fapiaoErrorMessage:" + fapiaoErrorMessage);
205
206            // 获取电子发票下载信息
207            GetFapiaoFileDownloadInfoResponse getFapiaoFileDownloadInfoResponse = client.run(
208                    getFapiaoFileDownloadInfoRequest);
209            for (FapiaoDownloadInfo fapiaoDownloadInfo : getFapiaoFileDownloadInfoResponse.fapiaoDownloadInfoList) {
210                if (Objects.equals(getFapiaoFileDownloadInfoRequest.fapiaoId, fapiaoDownloadInfo.fapiaoId)) {
211                    // 根据【下载发票文件】(https://pay.weixin.qq.com/doc/v3/partner/4015792569)指引，添加参数到downloadUrl，通过GET请求downloadUrl即可获取发票文件流
212                    String downloadUrl = fapiaoDownloadInfo.downloadUrl;
213                }
214            }
215        } catch (ApiException e) {
216            // 异常处理逻辑
217            if (e.getErrorCode().equals("SYSTEM_ERROR")) {
218                // 错误：系统错误
219                // 解决方式：稍后重试
220                // 描述：微信支付系统失败，建议等1分钟后再重试
221            } else if (e.getErrorCode().equals("FREQUENCY_LIMITED")) {
222                // 错误：限频报错
223                // 解决方式：稍后重试
224                // 描述： 接口频率限制，一定要原单重试，建议等1分钟后再重试
225            } else if (e.getErrorCode().equals("ERROR")) {
226                // 错误：系统错误
227                // 解决方式：系统繁忙，请稍后重试
228                // 描述：微信支付系统失败，建议等1分钟后再重试
229            } else if (e.getErrorCode().equals("NO_AUTH")) {
230                // 错误：服务商无权限
231                // 解决方式：根据具体message查看具体没有什么权限
232                // 描述：无权限的场景如：
233                // - 检查服务商商户号是否开通微信支付电子发票服务商权限，检查商户是否接受邀请开通授权微信支付电子发票能力，等待1分钟后重试
234                // - 开票申请单不是当前服务商创建，无权限进行当前操作
235                // - 商户乐企发票能力未授权，请授权相关发票能力 —— 确认通过【获取邀请商户开通服务商电子发票能力】(https://pay.weixin.qq.com/doc/v3/partner/4015941495)邀请追加能力开通，并且商户在电子税局乐企系统上完成授权
236                // - 商户未开通数电发票能力，请开通数电发票 —— 确认通过【获取邀请商户开通服务商电子发票能力】(https://pay.weixin.qq.com/doc/v3/partner/4015941495)邀请能力开通，并且商户在电子税局乐企系统上完成授权
237            } else if (e.getErrorCode().equals("SIGN_ERROR")) {
238                // 错误：签名错误
239                // 解决方式：检查平台商户证书序列号，证书私钥文件，公钥ID，公钥文件，同时确认下签名过程是不是按照微信支付的签名方式
240                // 描述：签名报错，需要确认签名材料和签名流程是否正确
241            } else if (e.getErrorCode().equals("PARAM_ERROR")) {
242                // 错误：参数错误
243                // 解决方式：按照报错返回的message，重新输入请求参数
244                // 描述：参数的类型，长度，或者必填选项没有填写等
245            } else if (e.getErrorCode().equals("RESOURCE_NOT_EXISTS")) {
246                // 错误：资源错误
247                // 解决方式：请检查发票申请单号是否正确，或在确认用户已提交抬头后重新调用
248                // 描述：根据发票申请单查询不到用户填写的抬头
249            } else if (e.getErrorCode().equals("RULE_LIMIT")) {
250                // 错误：条件限制
251                // 解决方式：按照报错返回的message接引操作后，重新调用
252                // 描述：需要按照指引重新处理的情况如:
253                // - 当前开票场景与发票申请单来源不匹配，请确认参数中的“开票场景”与“发票申请单号”是否符合要求。确认参数中的“开票场景”与“发票申请单号”是否对应
254                // - 商户尚未配置电子发票卡券模版信息，请先调用【创建电子发票卡券模板】（https://pay.weixin.qq.com/doc/v3/partner/4015792562）接口成功后再重新调用
255                // - 商户提交的购买方信息与用户填写的发票抬头不一致，请检查参数中的购买方信息与【获取用户填写抬头信息】（https://pay.weixin.qq.com/doc/v3/partner/4015784260）接口返回的发票抬头信息是否一致
256                // - 开票总金额不能超过发票申请单的总金额，请检查参数中各张发票的“总价税合计”，若是微信支付场景，不能超过微信支付订单的金额，若是非微信支付场景，
257                //   不能超过【获取用户抬头填写链接】（https://pay.weixin.qq.com/doc/v3/partner/4015770776）接口中指定的总金额
258            } else if (e.getErrorCode().equals("ORDER_CLOSED")) {
259                // 错误：订单错误
260                // 解决方式：联系商户，重新申请开具发票
261                // 描述：开票申请已被商户拒绝，无法进行当前操作
262            } else if (e.getErrorCode().equals("RESOURCE_ALREADY_EXISTS")) {
263                // 错误：资源已存在
264                // 解决方式：调用【查询电子发票】接口获取开票结果
265                // 描述：开票请求已被受理，请稍后调用【查询电子发票】接口获取开票结果
266            } else if (e.getErrorCode().equals("INVALID_REQUEST")) {
267                // 错误：请求非法，请求参数正确，但是不符合业务规则
268                // 解决方式：根据具体message查看具体哪里不符合业务规则，如果可以修改参数达到符合业务规则的修改请求符合业务规则之后重试
269                // 描述：不符合业务规则的场景如：
270                // - 交易信息中，交易金额必须大于0
271                // - 交易渠道非微信支付时，交易商户订单号必填
272                // - 微信支付交易信息金额错误
273                // - 多个微信支付渠道交易合并开票时，必须是同一个用户的所属交易账单
274                // - 交易单号在支付宝渠道下非法
275                // - 发票申请单申请开票的总金额，不能超过交易信息的总金额
276                // - 非折扣行金额必须为正数，请使用正确的参数重新调用
277                // - 总价税合计与所有发票行单行金额的累加和不相等，请使用正确的参数重新调用
278                // - 折扣行不能作为首行
279                // - 第{}行是折扣行，数电模式下，“单位”，“规格”必须为空，请使用正确的参数重新调用
280                // - 第{}行是折扣行，数电模式下，“货物或应税劳务、服务名称”，“税率”，“税收分类编码”，“优惠政策标识” 必须和被折扣行相同
281                // - 折扣行必须在被折扣行的下一行，请使用正确的参数重新调用
282                // - 折扣行金额必须为负数，请使用正确的参数重新调用
283                // - 折扣行金额绝对值不能超过被折扣行金额，请使用正确的参数重新调用
284                // - 折扣行的数量值非法，请使用正确的参数重新调用
285                // - 当前发票开具中，不可申请重开发票
286                // - 当前发票红冲中，不可申请重开发票
287                // - 申请开票次数，超过最大限制
288                // - 开票请求已被受理，请调用【查询电子发票】(https://pay.weixin.qq.com/doc/v3/partner/4015792567)接口获取开票结果
289                // - 交易单已申请开票，两次申请的交易金额不相同，修改交易金额重试
290                // - 交易可剩余开票金额不足，修改交易订单或者开票金额重试
291                // - 仅在微信支付侧开具的电子发票才允许下载发票文件
292            } else {
293                // 其他类型错误：联系获取支持
294            }
295        }
296    }
297}
298

1package com.tencent.wxpay.fapiao;
2
3import com.google.gson.annotations.SerializedName;
4import com.tencent.wxpay.utils.WXPayUtility;
5import com.tencent.wxpay.utils.WXPayUtility.Notification;
6import java.security.PublicKey;
7import java.util.List;
8import okhttp3.Headers;
9import okhttp3.Response;
10
11public class FapiaoIssuedNotifyDemo {
12    // TODO: 请准备商户开发必要参数，参考：https://pay.weixin.qq.com/doc/v3/partner/4013080340
13    // 商户号，是由微信支付系统生成并分配给每个商户的唯一标识符，商户号获取方式参考
14    // https://pay.weixin.qq.com/doc/v3/merchant/4013070756
15    private static String mchid = "19xxxxxxxx";
16    // 商户API证书序列号，如何获取请参考 https://pay.weixin.qq.com/doc/v3/partner/4013080340
17    private static String certificateSerialNo = "1DDE55AD98Exxxxxxxxxx";
18    // 商户API证书私钥文件路径，本地文件路径
19    private static String privateKeyFilePath = "/path/to/apiclient_key.pem";
20    // 微信支付公钥ID，如何获取请参考 https://pay.weixin.qq.com/doc/v3/partner/4013080340
21    private static String wechatPayPublicKeyId = "PUB_KEY_ID_xxxxxxxxxxxxx";
22    // 微信支付公钥文件路径，本地文件路径
23    private static String wechatPayPublicKeyFilePath = "/path/to/wxp_pub.pem";
24    // 商户APIv3密钥，如何获取请参考 https://pay.weixin.qq.com/doc/v3/partner/4013080340
25    private static String apiv3Key = "your apiv3 key";
26
27    public static class FapiaoIssued {
28        @SerializedName("mchid")
29        public String mchid;
30
31        @SerializedName("sub_mchid")
32        public String subMchId;
33
34        @SerializedName("fapiao_apply_id")
35        public String fapiaoApplyId;
36        
37        @SerializedName("fapiao_information")
38        public List<FapiaoInfo> fapiaoInformation;
39    }
40    
41    public static class FapiaoInfo {
42        @SerializedName("fapiao_id")
43        public String fapiaoId;
44        
45        @SerializedName("fapiao_status")
46        public Status fapiaoStatus;
47        
48        @SerializedName("card_status")
49        public CardStatus cardStatus;
50    }
51
52    public enum Status {
53        @SerializedName("ISSUE_ACCEPTED")
54        ISSUE_ACCEPTED,
55        @SerializedName("ISSUED")
56        ISSUED,
57        @SerializedName("REVERSE_ACCEPTED")
58        REVERSE_ACCEPTED,
59        @SerializedName("REVERSED")
60        REVERSED,
61    }
62
63    public enum CardStatus {
64        @SerializedName("INSERT_ACCEPTED")
65        INSERT_ACCEPTED,
66        @SerializedName("INSERTED")
67        INSERTED,
68        @SerializedName("DISCARD_ACCEPTED")
69        DISCARD_ACCEPTED,
70        @SerializedName("DISCARDED")
71        DISCARDED
72    }
73
74    public void FapiaoIssuedNotify(Response httpResponse) {
75        String refundNotifyStr = WXPayUtility.extractBody(httpResponse); // 用户填写抬头通知的原始字符串
76        Headers headers = httpResponse.headers(); // 用户填写抬头通知的Headers
77        PublicKey wechatPayPublicKey = WXPayUtility.loadPublicKeyFromPath(wechatPayPublicKeyFilePath);
78
79        Notification notification = WXPayUtility.parseNotification(
80                apiv3Key,
81                wechatPayPublicKeyId, wechatPayPublicKey, headers,
82                refundNotifyStr);
83
84        // 解析用户填写抬头信息
85        FapiaoIssued fapiaoIssued = WXPayUtility.fromJson(notification.getResource().getCiphertext(), FapiaoIssued.class);
86
87        String notifyMchId = fapiaoIssued.mchid;
88        if (mchid.equals(notifyMchId)) {
89            // 用于服务商获取电子发票信息
90            String subMchId = fapiaoIssued.subMchId;
91            String fapiaoApplyId = fapiaoIssued.fapiaoApplyId;
92            for (FapiaoInfo fapiaoInfo : fapiaoIssued.fapiaoInformation) {
93                Status fapiaoStatus = fapiaoInfo.fapiaoStatus;
94                switch (fapiaoStatus) {
95                    case ISSUED:
96                        // 使用回调的fapiao_apply_id，调用【查询电子发票】接口，获取发票详情
97                        break;
98                    case ISSUE_ACCEPTED:
99                        // 等待开票成功回调
100                        break;
101                    default:
102                        break;
103                }
104            }
105        }
106    }
107}