Once an order is successfully created in the web shop, a sales order is generated in the ERP system. This sales order is transferred, for example, via an API interface.
The import process is triggered when the order is released. This creates a transaction in the collana pay database and the corresponding transaction ID is inserted in the collana pay transaction ID field. At the same time, the status changes from empty to Import Pending. The status Import Pending means that a request has been sent to the collana pay API to import a previously created native PSP transaction into the collana pay database. At this moment, the system is waiting for a response from the collana pay API. The response will indicate whether the import process was successful or not. As long as the status Import Pending is displayed, the request is being processed and the system is waiting for a confirmation or rejection of the import.
If the response is successful, the transaction is imported into the Collana Pay database and the status changes to Import Completed.
Once the notification has been successfully processed, the order will have the status Import OK.
import
If the web shop or another third-party system does not communicate directly with the PSP via collana pay, it is possible to import an already started transaction into collana pay and process it further. collana pay checks the amounts (if possible) at the PSP.
Example: The customer placed the order in the web shop and the payment was processed there via a standard plug-in of a PSP. The order has been transferred to the ERP system and checked. The order is ready to be processed.
status
The status of the transaction is requested from collana pay. The entire transaction is returned with all previous interactions. There is no communication with the PSP.
capture
The capture captures the reserved amount. The money is requested from the user by the PSP.
Example: The order has been checked and it has been ensured that the goods can be delivered. The amount is requested and the order can be sent to logistics.
reserve
If the amount or part of the amount is to be refunded, the refund endpoint can be used. The money is then credited back to the user via the PSP.
Example: The customer does not want to keep the received goods and returns them. The return is received and after successful verification of the goods, the money is credited to the customer.
The alternative to the import architecture is the direct connect architecture.