As part of the integration of payment systems with Shopify, status management is a crucial step to ensure proper order processing. Below is a detailed overview of the rules and mappings applied to define payment statuses and ensure optimal synchronization.
Definition of the Status for a Completed Payment
For a payment link to be considered completed, its status attribute must be set to COMPLETED.
- Essential condition: If this attribute does not have this value, no order will be imported into Shopify.
It is therefore crucial to verify this condition before any attempt to integrate or import data.
👉 Reference: Please see the Payment Links Statuses section in the Bridge documentation for detailed information.
Updating the Order Status After Payment
After a payment is processed, the system updates the order status based on the funds status associated with the payment link, identified by the fund_information.status attribute. This mapping is determined according to the following rules:
Payment Status Mapping
-
Payment Accepted
The payment is considered accepted when the status is one of the following:
- PAID: Exact amount paid.
- OVERPAID: Amount paid exceeds the requested amount.
These statuses indicate that the order is fully validated and ready for processing.
‼️ The OVERPAID status means the payment was made via a VIBAN with an overpayment. A partial refund is therefore necessary.
-
Payment Refused
The payment is considered refused if the status is set to:
- RECALLED: Payment canceled or funds recalled.
In this case, the order will not be processed, and the final status will reflect the payment rejection.
- Payment Pending
In all other cases not mentioned above, the payment will be marked as pending.
- Important exception: If the order already has a final status (accepted or refused), no status change will be made.
👉 Reference: Please see the Fund Information Status section in the Bridge documentation for more details on the various fund statuses.
Conclusion
Payment status management relies on clear and rigorous logic that ensures consistency between payment systems and Shopify. Adhering to the conditions described for the status and fund_information.status attributes is essential to guarantee a successful integration and avoid any malfunctions in the order processing workflow.
For a successful implementation, it is recommended to:
- Systematically verify payment statuses before importing orders.
- Refer to the Bridge documentation to better understand the various statuses and their impact on the system.