From 363ebd96917fab905bb676501761cecaad5187eb Mon Sep 17 00:00:00 2001 From: Ines MultiSafepay <“ines.mayer@multisafepay.com”> Date: Wed, 29 May 2024 11:00:27 +0200 Subject: [PATCH 1/4] DOCS-4245 Order save inspector --- content/integrations/magento-2.md | 16 ++++++++++++++++ 1 file changed, 16 insertions(+) diff --git a/content/integrations/magento-2.md b/content/integrations/magento-2.md index 2d36fc8ea..b6cb4cc5b 100755 --- a/content/integrations/magento-2.md +++ b/content/integrations/magento-2.md @@ -731,6 +731,22 @@ If you installed the plugin via the Magento Marketplace, go to **System** > **We
--- +## Troubleshooting + +
+How to troubleshoot Magento 2 issues +
+ +### Order status updates + +If you experience issues with order statusses not being updated correctly (e.g. incongruence pending - processing), consider the following: + +- this is generally caused by third party solutions interfering in the order processing flow and the observer being based on a different instance of the order object. +- to debug this issue on your side, check our Order Save Inspector + + +
+ [block:html] { From ebfefda3bf38e85583a25c1544f0ada1d19a1e89 Mon Sep 17 00:00:00 2001 From: Ines MultiSafepay <“ines.mayer@multisafepay.com”> Date: Wed, 5 Jun 2024 12:13:47 +0200 Subject: [PATCH 2/4] DOCS-4245: add GET order POS --- content/point-of-sale/smartpos-solutions.md | 118 ++++++++++++++++++++ 1 file changed, 118 insertions(+) diff --git a/content/point-of-sale/smartpos-solutions.md b/content/point-of-sale/smartpos-solutions.md index 3beccc86d..ccae5a8fd 100644 --- a/content/point-of-sale/smartpos-solutions.md +++ b/content/point-of-sale/smartpos-solutions.md @@ -145,6 +145,124 @@ curl -X POST \ 2. To initiate payments - see MultiSafepay Android POS integration .
+# API features + +In addition to the features mentioned in our API reference, there are POS-specific details you can retrieve via our API, including the **Terminal ID** that processed a transaction. + +**Example GET order** + +``` + +{ + "success": true, + "data": { + "amount": 1, + "amount_refunded": 0, + "completed": "2024-06-04T15:50:18", + "costs": [ + { + "amount": 2, + "description": "2 For Visa Transactions", + "transaction_id": 899813954, + "type": "SYSTEM" + }, + { + "amount": 0.6, + "description": "2.9 % For Visa CreditCards Transactions (min 60)", + "transaction_id": 899813955, + "type": "SYSTEM" + } + ], + "created": "2024-06-04T15:50:17", + "currency": "EUR", + "custom_info": { + "custom_1": null, + "custom_2": null, + "custom_3": null + }, + "customer": { + "address1": null, + "address2": null, + "city": null, + "country": null, + "country_name": null, + "email": null, + "first_name": null, + "house_number": null, + "last_name": null, + "locale": "en_US", + "phone1": null, + "phone2": null, + "state": null, + "zip_code": null + }, + "description": "12341234", + "fastcheckout": "NO", + "financial_status": "completed", + "items": null, + "modified": "2024-06-04T15:50:18", + "order_id": "TestGetOrder123123", + "payment_details": { + "account_holder_name": "card holder", + "account_id": null, + "application_id": "a0000000031010", + "authorization_code": "705151", + "card_acceptor_id": "1001001", + "card_acceptor_location": "Amsterdam", + "card_acceptor_name": "TestMSP", + "card_additional_response_data": { + "sca_details": {} + }, + "card_authentication_result": null, + "card_entry_mode": "ICC_CONTACTLESS", + "card_expiry_date": "3112", + "card_funding": "D", + "card_product": "F", + "card_product_type": 1, + "card_sequence_number": "0000", + "card_verification_result": "2", + "cardholder_verification_method": "FAILED", + "cardholder_verification_result": "UNKNOWN", + "emv": { + "91": "ab1231231234" + }, + "external_transaction_id": "12312312312", + "issuer_bin": "123123", + "issuer_country_code": "ES", + "last4": "1234", + "recurring_flow": null, + "recurring_id": "1231213123", + "recurring_model": null, + "response_code": "00", + "scheme_reference_id": "123123123123123", + "terminal_id": "0000004d", + "type": "VISA" + }, + "payment_methods": [ + { + "account_holder_name": "card holder", + "amount": 1, + "card_expiry_date": "3112", + "currency": "EUR", + "description": "12341234", + "external_transaction_id": "123123412341234", + "payment_description": "Visa", + "status": "completed", + "type": "VISA" + } + ], + "reason": "Approved", + "reason_code": "1000", + "related_transactions": null, + "status": "completed", + "transaction_id": 123412342341234, + "var1": null, + "var2": null, + "var3": null + } +} + +``` # Handle notifications From b8485352b44eac3ef54833f3173fa45776ffb756 Mon Sep 17 00:00:00 2001 From: Ines MultiSafepay <“ines.mayer@multisafepay.com”> Date: Mon, 10 Jun 2024 12:25:41 +0200 Subject: [PATCH 3/4] DOCS-4245 M2 Troubleshooting guide --- content/integrations/magento-2.md | 13 +++++++++---- 1 file changed, 9 insertions(+), 4 deletions(-) diff --git a/content/integrations/magento-2.md b/content/integrations/magento-2.md index b6cb4cc5b..5e93fec10 100755 --- a/content/integrations/magento-2.md +++ b/content/integrations/magento-2.md @@ -737,13 +737,18 @@ If you installed the plugin via the Magento Marketplace, go to **System** > **We How to troubleshoot Magento 2 issues
-### Order status updates +### Order status update -If you experience issues with order statusses not being updated correctly (e.g. incongruence pending - processing), consider the following: +If you experience issues with order statusses not being updated correctly (e.g. incongruence pending - processing), this might happen randomly and be difficult to replicate. -- this is generally caused by third party solutions interfering in the order processing flow and the observer being based on a different instance of the order object. -- to debug this issue on your side, check our Order Save Inspector +This is generally caused by third party solutions interfering in the order processing flow and the observer being based on a different instance of the order object. +_Tip_: this issue might appear after upgrading to our latest plugin version, for example because faster notification processing times surface an already existing update conflict. + +To debug this issue on your side: + +1. Set to debug mode +2. Use our [Order save inspector](https://github.com/MultiSafepay/magento2-order-save-inspector) to check which module might interfere (for example delivery software, ERP). From af4d559373d70bf110fab460baf5b741ab694c38 Mon Sep 17 00:00:00 2001 From: Ines MultiSafepay <“ines.mayer@multisafepay.com”> Date: Mon, 10 Jun 2024 12:30:57 +0200 Subject: [PATCH 4/4] DOCS-4245 M2 Troubleshooting guide --- content/integrations/magento-2.md | 14 +++++--------- 1 file changed, 5 insertions(+), 9 deletions(-) diff --git a/content/integrations/magento-2.md b/content/integrations/magento-2.md index 5e93fec10..b6a09dd89 100755 --- a/content/integrations/magento-2.md +++ b/content/integrations/magento-2.md @@ -737,20 +737,16 @@ If you installed the plugin via the Magento Marketplace, go to **System** > **We How to troubleshoot Magento 2 issues
-### Order status update +### Order Status Update -If you experience issues with order statusses not being updated correctly (e.g. incongruence pending - processing), this might happen randomly and be difficult to replicate. +If you experience issues with order statuses not being updated correctly (e.g., incongruence between pending and processing), this might happen randomly and be difficult to replicate. This is generally caused by third-party solutions interfering in the order processing flow and the observer being based on a different instance of the order object. -This is generally caused by third party solutions interfering in the order processing flow and the observer being based on a different instance of the order object. - -_Tip_: this issue might appear after upgrading to our latest plugin version, for example because faster notification processing times surface an already existing update conflict. +_Tip_: This issue might appear after upgrading to our latest plugin version, possibly due to faster notification processing times surfacing an already existing update conflict. To debug this issue on your side: -1. Set to debug mode -2. Use our [Order save inspector](https://github.com/MultiSafepay/magento2-order-save-inspector) to check which module might interfere (for example delivery software, ERP). - - +1. Set to debug mode. +2. Use our [Order Save Inspector](https://github.com/MultiSafepay/magento2-order-save-inspector) to check which module might interfere (for example, delivery software, ERP). [block:html]