Transaction pre-authorisation

Transaction pre-authorisation allows you to capture or reject a paid transaction using dedicated requests to the relevant imoje API endpoints.

By default, pre-authorisation is disabled and all transactions are accepted automatically. If you want to enable pre-authorisation in your shop, please contact us at kontakt.tech@imoje.pl.

How transaction pre-authorisation works

Once pre-authorisation is enabled, each paid transaction receives the status authorised (Awaiting confirmation) and a notification with the same status is sent to the shop. In the next step, you can take one of the following actions:

• Capturing (approving) the transaction

  To approve the transaction, send a POST request to the endpoint /{merchantId}/transaction/{{transactionId}}/capture. As a result, the transaction will receive the final status settled (Completed).

• Rejecting a transaction

  To reject a transaction, send a POST request to the endpoint /{merchantId}/transaction/{{transactionId}}/void. As a result, the transaction will receive the final status cancelled.