Antom, leading provider of tailored payment solutionsAntom, leading provider of tailored payment solutions

Order number management

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 information:
    • Merchant internal order number
    • Merchant payment request order number (to the acquirer)
    • Acquirer order number
  • Connecting with acquirers through APO: You must manage the following parameters:
    • Merchant internal order number
    • 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 merchantAccountID, 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 merchantAccountID:

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