# 1. Business Mode Description
# 1.1 Payee Organization + Finance Bureau
The payee organization is responsible for obtaining authorization from the user for billing, and the finance bureau is responsible for issuing e-bills and adding them to users' Cards & Offers. This mode is suitable for the scenarios where the payee organization and finance bureau are independent of each other.
# 1.2 Self-deployed Platform
The self-deployed platform assumes the responsibilities of both the payee organization and finance bureau. This mode is suitable for the scenarios where the same role is responsible for obtaining authorization from users and issuing e-bills.
# 2. Account and Configuration
# 2.1 Information Required for Payee Organization
(1) Go to the Weixin Official Accounts Platform to apply for an Official Account, and get appid and appsecret for calling APIs. (2) Obtain the access_token. For more information, see the API List. (3) Obtain the ticket. For more information, see the API List. (4) Configure the Official Account callbacks. For more information, see the API List. (5) Apply for the API permissions for the payee organization's Official Account: The payee organization applies for Weixin Financial E-Bill permissions by sending the following information to wxfapiao@tencent.com.
Payee Organization Name | Payee Organization's Qualification Document (copy of the Organization Code Certificate) | Business Description | Contact Person and Information | Official Account appid |
---|---|---|---|---|
(6) If the e-bills are issued via an app, go to the Weixin Open Platform to apply for an account to create the app, and obtain the appid and appsecret. In addition, send the following information to wxfapiao@tencent.com to apply for API permissions.
Payee Organization Name | Payee Organization's Qualification Document (copy of the Organization Code Certificate) | Business Description | Contact Person and Information | Official Account appid | Open Platform appid |
---|---|---|---|---|---|
(7). Request the s_pappid from the finance bureau.
# 2.2 Information Required for the Finance Bureau
(1) Go to the Weixin Official Accounts Platform to apply for an Official Account, and get appid and appsecret for calling APIs.
(2) Obtain the access_token. For more information, see the API List.
(3) Configure the Official Account callbacks. For more information, see the API List.
(4) Apply for API permissions for the finance bureau:
(5) Obtain the s_pappid and provide it to the payee organization. A finance bureau only has one s_pappid so you only need to call the API once and save the s_pappid for later use. For more information, see the API List.
(6) Create a financial e-bill template card_id. A finance bureau can work with multiple payee organizations, and each payee organization can only have a unique card_id. For more information, see the API List.
# 2.3 Information Required for the Self-deployed Platform
A self-deployed platform assumes the responsibilities of both the payee organization and finance bureau, so you need to prepare the information required for both the payee organization and finance bureau. For more information, see "Information Required for the Finance Bureau" and " Information Required for the Finance Bureau".
# 3. Business Process
We provide different methods to work with financial e-bills to cater to the needs of different scenarios, including receiving e-bills via Official Account and via app. The following describes the business process in each scenario in the "payee organization + finance bureau" mode. The business process for the self-deployed platform mode is the combination of the steps for both payee organization and finance bureau.
# 3.1 Receiving E-Bills via Official Account
In the Official Account scenario, the non-tax revenue e-bills are issued by following the steps below:
(1) The finance bureau obtains the s_pappid and provides it to the payee organization. A finance bureau only has one s_pappid so you only need to call the API once and save the s_pappid for later use. For more information, see the API List.
(2) The payee organization obtains the access_token. For more information, see the API List.
(3) The payee organization obtains the ticket. For more information, see the API List.
(4) The payee organization obtains the authorization page URL. For more information, see the API List.
(5) The payee organization provides the authorization page URL to the user, who then taps the URL to open the authorization page. The interaction process is shown below:
(6) The payee organization receives the user authorization callback, which indicates that the user has authorized the collection of financial e-bill, and then notifies the finance bureau to issue the financial e-bill. For more information, see the API List.
(7) The finance bureau creates a financial e-bill template card_id. A finance bureau can work with multiple payee organizations, and each payee organization can only have a unique card_id. For more information, see the API List.
(8) The finance bureau uploads the PDF file of the financial e-bill to the Weixin Financial E-Bill Platform. For more information, see the API List.
(9) The finance bureau checks the PDF uploaded to the Weixin Financial E-Bill Platform. For more information, see the API List.
(10) The finance bureau adds the financial e-bill to the user's Cards & Offers. For more information, see the API List. The user receives the following template message:
(11) The user checks the financial e-bill in Weixin as shown below:
# 3.2 Receiving E-bills via App
In the app scenario, a non-tax revenue e-bill is issued by following the steps below:
(1) The finance bureau obtains the s_pappid and provides it to the payee organization. A finance bureau only has one s_pappid so you only need to call the API once and save the s_pappid for later use. For more information, see the API List.
(2) The payee organization obtains the access_token. For more information, see the API List.
(3) The payee organization obtains the ticket. For more information, see the API List.
(4) The payee organization obtains the authorization page URL. For more information, see the API List.
(5) The payee organization goes to the Weixin authorization page from the app and asks the user to tap "Authorize". The interaction process is shown below:
(6) A Weixin Open Platform account is unable to receive callbacks. Therefore, the user authorization callback is received by the payee organization's Official Account. When receiving the callback that indicates the user has authorized the collection of e-bill, the payee organization notifies the finance bureau to issue the e-bill. For more information, see the API List.
(7) The finance bureau creates a financial e-bill template card_id. A finance bureau can work with multiple payee organizations, and each payee organization can only have a unique card_id. For more information, see the API List.
(8) The finance bureau uploads the PDF file of the financial e-bill to the Weixin Financial E-Bill Platform. For more information, see the API List.
(9) The finance bureau checks the PDF uploaded to the Weixin Financial E-Bill Platform. For more information, see the API List.
(10) The finance bureau adds the financial e-bill to the user's Cards & Offers. For more information, see the API List. The user receives the following template message:
(11) The user checks the financial e-bill in Weixin as shown below: