Card Payment - Direct API Mode Integration

This document describes the integration requirements for using card payments under direct API payments.

Note:

As opposed to Cashier Card Payment, merchants need to build their own payment checkout page, payment result page, etc., and are also unable to use the Recommended Card Capability under cashier card payment.

1. Integration Preparation

• In card payment, if a merchant processes card information on its own, it must be qualified for PCI DSS certification , and contact the PayerMax Commerce team to provide PCI certification materials. Merchants can also use the PayerMax Tokenization to avoid the PCI DSS qualification requirement.

• For other preparations, please view Direct API Payment - Integration Preparation .

2. Interaction Process

View the Direct API Payment - Interaction Process .

3. Interface List

View the Direct API Payment - Interface List .

4. Environmental Information

• Test Environment：https:// pay-gate-uat.payermax.com/aggregate-pay/api/gateway/ <Interface PATH>

• Integrated Environment：https:// pay-gate.payermax.com/aggregate-pay/api/gateway/ <Interface PATH>

5. Integration Steps

5.1 Create Payment

Merchants can through /orderAndPay API interface creation payment, richer request entry compared to Cashier Card Payment , for example, merchants can using dynamic 3DS services .

5.1.1 PCI Qualified

View the Direct API Payment - Create Payment .

5.1.2 Non PCI qualified

If the merchant does not have PCI DSS qualification, it can achieve secure and compliant card payment through PayerMax Tokenization Solution, please refer to 【Tokenization支付】.

5.2 Completion of 3DS Certification

View the Direct API Payment - Jump to User Authentication .

5.3 Get Payment Results

View the Direct API Payment - Get Payment Result .

6. Test Go Live

After the merchant has completed the above integration steps, he/she can initiate the actual payment request for preliminary testing and validation, please refer to Integration Testing - Start a test for the specific steps.

After the test is passed and before the final release, the merchant must contact PayerMax technical support to submit the order information for the test so that PayerMax can check the request logs and data to confirm that you have correctly integrated the relevant capabilities, as described in Integration Testing - Initiate Acceptance.

After passing the acceptance test, the merchant can configure integration information for production environments and prepare for the opening of the volume.

In addition, under Acquiring Product Integration, there are integration documents for the various payment methods supported by PayerMax, which contain instructions for testing each payment method.

7. Troubleshooting

For response errors during testing or acceptance, you can refer to Troubleshooting - Error Code. Meanwhile, in FAQs, we summarize and list all kinds of common problems and how to deal with them.

You can also contact PayerMax technical support team directly for any questions during integration, testing and acceptance.