Developer Center User Guide

1. Access Instructions

1.1 Account Application

Log in "Developer Center". If you have contacted the business registration PayerMax backstage , you can log in directly with PayerMax account. You can also use any email to directly register the developer platform and use it.

1.2 Joint Debugging

a. Please first confirm whether you need to access the acquiring or payment products. 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 interface that is connected must be tested for positive and negative test cases, and the callback interface must ensure the correct response message to ensure the quality of access and reduce production line problems.

d. Testing environment mock payment, please refer to "Collaction Transaction Test" and "Disbursement Transaction Test".

1.3 Release

a. After the joint debugging is completed, please consult the entrance in the lower right corner of the developer platform, submit the ticket to complete the acceptance, the required materials:

• A successful order, a failed order (please note that the asynchronous callback response to PayerMax should be normal, please all respond {" msg ": "Success", "code": "SUCCESS"} , only represents that you have received the callback, does not represent the order status.)
• Provide PayerMax production line merchant number (provided by our business to your company)

b. Acceptance is completed: you can log in to the PayerMax background (set service-development parameters) to obtain the production line merchant number, AppID , PayerMax public key information, and upload the merchant public key information.

c. Acceptance not completed:

• If there is a problem with the docking, please modify it and resend the order to apply for acceptance;
• If the production line contract is not yet effective, you can also inquire about the progress with our business.

2. Developer Center

2.1 Development Parameter Configuration

• Merchant number: The system automatically generates for developers to test the environment.
• APPID: Merchant App Id, the unique identifier that PayerMax assigns to the merchant app.
• Key type：RSA.
• Public key upload: Developers need to upload the merchant's public key to payermax to verify the merchant's signature and prevent the message from being tampered with during network transmission.

2.2 Notification Address

Developers can set corresponding notification addresses for different transaction types, so that the access server level can receive asynchronous callback results from the PayerMax server level.

Note:

• If the background is not configured, it can be passed in the notifyUrl of the order parameter.
• If neither the background nor the order parameters are present, PayerMax will not call back.
• Common callbacks:
  • Acquiring business: acquiring, refund (if there is an api refund can be matched, production line orders can also be manually initiated by the merchant platform), dispute (production line transactions can be queried by the merchant platform)
  • Disbursement business: Disbursement.
  • For other notices, please confirm your company's integration mode first. If it has not taken effect, you can consult ticket.

2.3 Payment Method On and Off

Default payment methods are all enabled, you can turn off some payment methods.

3. Developer Tools

3.1 RSA Key Generation

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

3.2 RSA Signature

• Merchant private key: Simply 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 endorsement data.
• PayerMax public key：In Basic Settings - Development Info - Public Key Upload, click Copy.

3.3 Send Demo

Merchant number, appId can be in the basic settings - development information acquisition, upload the corresponding parameter point to send a request.

3.4 Log Query

Logs of the past three days can be queried.

3.5 Order List

3.6 Ticket Entrance

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