After integrating with acquirers through APO, the management of order numbers has changed compared to when you integrate directly with an acquirer. You need to maintain an appropriate order number system based on the different integration methods:

• Connecting directly with acquirers: You must manage the following parameters:

• merchantId
• paymentRequestId
• acquirerInfo.acquirerTransactionId.

• Connecting with acquirers through APO: You must manage the following parameters:

• merchantId
• paymentRequestId
• paymentId
• acquirerInfo.referenceRequestId
• acquirerInfo.acquirerTransactionId

Use Cases for acquirerTransactionId

Reconciliation

If you use the original reports provided by the acquirer for reconciliation, which typically include the acquirer-side order number, you need to store the information of acquirerInfo.referenceRequestId and acquirerInfo.acquirerTransactionId. With this information, your finance team can match acquirerInfo.acquirerTransactionId with merchantId, enabling streamlined reconciliation.

Dispute

For card payments, you need to contact the correesponding acquirer to handle the dispute if it occurs. The acquirer can provide you with acquirerInfo.acquirerTransactionId. Use the following methods to obtain the information on merchantId:

• It is recommended to save the information of acquirerInfo.referenceRequestId and acquirerInfo.acquirerTransactionIdreturned by the API. Your operation team can query the corresponding merchantId on the internal platform using acquirerInfo.acquirerTransactionId.
• Log in to APO Dashboard and search for merchantId using acquirerInfo.acquirerTransactionId.