Amazon Payfort (Amazon Payment Services) Extension
Supported features:
-
Credit card payments (Visa, MasterCard, AMEX)
-
Tokenization (Reusing credit cards)
-
Installments
-
Apple Pay
Not supported features:
Configuration:
For official magento integration guide look here.
For configuring you will need merchant account and access to Payfort(Amazon Payment Services) system: Website.
To configure merchant settings of extension
get your credentials from: testfort.payfort.com or fort.payfort.com. From homepage navigate to: Merchant Management -> (Select merchant account from the merchants list) -> Security Settings.
You need the following information:
-
Merchant Identifier
-
Access Code
-
SHA Request Phrase
-
SHA Response Phrase
You will input this information in Magento admin panel in: Stores -> Configuration -> Sales -> Payment Methods -> (Scroll to payfort) -> Configure -> APS Merchant Configurations.
To configure Apple Pay settings of extension
get your credentials from testfort.payfort.com or fort.payfort.com, navigate to Merchant Management -> (Select Apple Pay from merchants list) -> Security Settings.
You need the following information:
-
Merchant Identifier
-
Access Code
-
SHA Request Phrase
-
SHA Response Phrase
More on Apple pay certificates:
You will need to upload a .p12 (Personal Information Exchange) password encrypted Apple Payment Processing certificate and key to Payfort. In testfort.payfort.com or fort.payfort.com, in Apple Pay merchant and in Apple Pay Settings.
To generate Apple Payment Processing certificate exchange (.p12) file you will first need to generate an Apple Payment Processing certificate (.cer) which you can generate or get access through Apple Developer Account and Mac OS Keychain tool(Which you will need to generate private keys for the certificates).
You also need an Apple Merchant Identity certificate which you can generate or get access through Apple Developer Account and Mac OS Keychain tool. After generating it, convert it to Certificate exchange (.p12) file and convert it to key.pem and certificate.pem.
Upload key.pem and certificate.pem files which you generated from Merchant Identity certificate exchange file (.p12) to Payfort’s Magento configuration at: Stores -> Configuration -> Sales -> Payment Methods -> Payfort configuration -> Apple Pay.
In production mode, you will also need to verify merchant domain (Not needed in sandbox mode).
Full guide to generating and using Apple credentials can be found here
Credit Card and Installments payment methods configuration:
In Amazon Payment Service settings, configure Credit Card and installments to use “Standard” integration:
-
Go to -> Credit/Debit cards and select “Integration type” -> Standard.
-
Go to -> Installments and select “integration type” -> Standard.
Debugging
To enable debugging, in magento admin, go to Amazon Payment Services Global configurations -> Debug, set to “yes”.
Logs will be generated in the project’s root var/log/debug.log file.
To enable/disable sandbox, go to Amazon Payment Services Global configurations -> Sandbox, yes/no.
Development
General information and Integration API
Official API for integration
This Payfort (Amazon Payment Services) extension uses Official Magento 2 Payfort extension as dependency.
Implementation:
-
This extension overrides blocks and controllers from Amazonpaymentservices module for scandipwa compatibility.
-
The implementation is based on original extension’s “Standard Checkout” functionality.
-
In original extension on luma, Standard Checkout is done through full page redirects. In this compatibility, MerchantPageResponse and InstallmentResponse controllers were modified to handle errors to FE and to replace full page redirects with JS events instead which makes user experience smoother.
-
Placing orders is done using custom PayfortPlaceTransaction and PayfortSendPaymentToAps resolvers.
-
Order cancellation is handled using OrderCancel resolver.
