Developer Center User Guide

1. Access Instructions

1.1 Account Application

Log in to the Developer Platform. If you have registered the PayerMax backend with the business, you can directly log in with the PayerMax account; you can also use any email address to directly register the Developer Center and use it.

1.2 Test Joint Debugging

a. Please confirm whether you need to access the acquiring or payment product. The acquiring can match the required integration mode according to your product.

b. Obtain the test merchant number, AppID, and PayerMax public key information through the developer platform Basic Settings → Development Information, and upload the merchant public key information.

c. Each access interface must be tested with positive and negative use cases, and the callback interface must ensure the correct response message to ensure the quality of access and reduce production line problems.

d. For mock payment in the test environment, please refer to Acquiring transaction test and Payment transaction test.

1.3 Online

a. After the joint debugging is completed, please go to the Acceptance menu on the developer platform to self-accept:

b. Acceptance completed

• You can log in to the PayerMax backend Set Service → Development Parameters to obtain the production line merchant number, AppID, PayerMax public key information, and upload the merchant public key information;

• Administrators can Set up service → Payment method availability menu to view the available payment methods for the production line. The administrator can also assign viewing permissions to operators.

c. Acceptance is not completed

• If there is a connection problem, please modify and re-request, and then accept again;

• If the production line contract has not taken effect, you can also ask our business for progress.

2. Developer Center

2.1 Development Parameter Configuration

• Merchant Number: Automatically generated by the system for use in the developer test environment;

• APPID: Merchant application ID, the unique identifier assigned by PayerMax to the merchant application;

• Key Type: RSA;

• Public Key Upload: Developers need to upload the merchant public key to PayerMax to verify the merchant signature and prevent the message from being tampered with during network transmission;

• Invite Collaborator: The invitee and you share the same developer platform merchant number;

• Bind Production Line Merchant Number: After the test environment is jointly debugged and accepted with the developer platform merchant number, the corresponding production line merchant number development parameters can be configured on the merchant platform.

2.2 Notification Address

Developers can set corresponding notification addresses according to different transaction types, so that the access server can receive the asynchronous callback results of the order provided by the PayerMax server.

Note:

• If the backend is not configured, it can be passed in the notifyUrl of the order parameter
• If there is no configuration in the backend and the order parameter, PayerMax will not call back
• Common callbacks:
• Acquisition business: Acquisition, refund (if there is an API refund, the production line order can also be manually initiated by the merchant platform), dispute (production line transactions can be queried by the merchant platform)
• Withdrawal business: Withdrawal
• For other notifications, please confirm your company's integration mode first. If it is not effective, you can consult the work order

2.3 Payment method on and off

By default, all payment methods are enabled, and you can disable certain payment methods.

3. Developer Tools

3.1 RSA Key Generation

Click Generate Key Pair to automatically generate the merchant private key and public key.

3.2 RSA Signature

• Merchant Private Key: Just upload the private key generated in the previous step. Note: The merchant public key needs to be uploaded to Basic Settings → Development Information → Public Key Upload;

• Request Message: Interface Body request body (original request body, do not format);

• Click "Add Signature" to generate signature data;

• PayerMax Public Key: In Basic Settings → Development Information → Public Key Upload, click Copy.

3.3 Request Example

By default, the merchant number and appId are taken from the configuration in Basic Settings → Development Information. You select the interface name and fill in the merchant private key, and click the Send Request button.

3.4 Request log

You can query the logs of the past three days.

3.5 Order List

3.6 Work Order Entry

Click the consultation button in the lower right corner to initiate a work order consultation.