Linking mechanism

The Linking Mechanism allows our system to connect multiple corresponding payments, providing a clear audit trail for funds. For example, a Gateway Payment is automatically linked back to the original Incoming Accounts Payment, and a Reversal is linked to the transaction it corrects. This mechanism is essential for accurate reporting and reconciliation, as it allows your system to easily track the lifecycle of funds.

Transaction links are represented using HTTPS route–style identifiers, making them easy to reference, traverse, and resolve via the API.

Self links exist for every transaction, providing a reference to the transaction itself. Other links are present only when a transaction has an actual connection to another transaction(s), such as a reversal or a gateway payment.

This mechanism is essential for accurate reporting and reconciliation, as it allows your system to easily track the full lifecycle of funds.

Link Type	Description
self	Links the transaction to itself.
reversal	Links a transaction to its reversal.
gatewayPayment	Links an transaction to the payment gateway.
correspondingInternal	Links transaction to its corresponding internal transaction.
accountHolderVerification	Links a transaction to an account holder verification process.

Example for internal transaction:

"_links": {
    "self": {
      "href": "/transactions/ba637b22-1077-4c39-9e48-2d20cd0c5b20",
      "method": "GET"
    },
    "correspondingInternal": {
      "href": "/transactions/2b8e068f-b82e-49f0-8073-70f3c37434a3",
      "method": "GET"
    }
  }