OpenCart Plugin
Copy page
Copy page as Markdown for LLMs
Open in ChatGPT
Ask questions about this page
Open in Claude
Ask questions about this page
Accept payments on your OpenCart platform using the Amazon Payment Services plugin for seamless payment processing.
Prerequisites
Before you begin, ensure you have:
- OpenCart installed and configured
- Amazon Payment Services test account for testing
- OpenCart admin access with extension installation permissions
- SSL certificate installed on your website
Supported integration types and payment methods
| Supported Integration types | Supported Payment methods |
|---|---|
| Hosted Checkout | Visa, Mastercard, AMEX, MADA, Meeza, Apple Pay, KNET, NAPS, Benefit, OmanNet, STC Pay |
| Custom Integration | Visa, Mastercard, AMEX, MADA, Meeza, Apple Pay, STC Pay |
Install the plugin
Download Plugin
Visit our GitHub repository and download the latest release as a .zip file.
Access OpenCart Admin
Sign in to your OpenCart admin panel and navigate to Extensions → Installer.
Upload Extension
Click Upload button, select the downloaded .zip file, and wait for upload to complete.
Install Extension
Go to Install History section, find the uploaded Amazon Payment Services extension, and click Install button.
Configure the plugin
Required Credentials
Before configuring the plugin, gather these credentials from your Amazon Payment Services test account by navigating to Security Settings tab where you will find:
merchant_identifier- Your unique merchant IDaccess_code- API access code for authenticationrequest_sha_phrase- SHA phrase for request signingresponse_sha_phrase- SHA phrase for response verificationsha_type- Hashing algorithm (SHA256 or SHA512)
Configuration Steps
Navigate to Payment Settings
Go to Extensions → Extensions, under Choose the extension type select Payments, find "Amazon Payment Services" in the payments list, and click the Edit icon to open configuration.
Configure Global Settings
Complete the following core settings:
| Setting | Description |
|---|---|
| Enabled | Select Yes to enable the plugin; No to disable the plugin |
| Merchant Identifier | Amazon Payment Services account merchant identifier |
| Access Code | Amazon Payment Services account access code |
| Request SHA Phrase | Amazon Payment Services account SHA Request Phrase |
| Response SHA Phrase | Amazon Payment Services account SHA Response Phrase |
| Sandbox Mode | Select Yes for testing environment; No for production/live account |
| Command | Set as PURCHASE for direct capturing of the amount or AUTHORIZATION for holding the amount and capturing it later on |
| SHA Type | Value should be the same as the value under security settings in your account |
| Gateway Currency | If you are using OpenCart multi-currency: 1. Select Front which uses the customer's selected currency. 2. Select Base which uses store's default currency. If multi-currency is disabled, both options are the same. Note: Make sure the currency you will process payments with is active on your Amazon Payment Services account |
| Debug Mode | Enable debug mode to save all transaction logs |
| Host to Host URL | This is used as a Webhook URL. Host to Host URL needs to be set in your Amazon Payment Services account for feedback and transaction notifications under Technical Settings tab |
| Enable Tokenization | Enable if you need your customers to securely save cards on Amazon Payment Services. The Save My Card button appears for Debit/Credit Card and Installment payments. Saved cards can be managed in the My Account page in OpenCart |
| Hide delete token button | Allows users to delete saved cards in their Account, except for those linked to active subscriptions |
Credit/Debit configuration
| Setting | Description |
|---|---|
| Enabled | Should be Yes |
| Integration Type | Select the type that is active on your account, Redirection or Custom Integration |
| Sort Order | On the checkout page, you can manage orders for all payment options |
| Show Mada Branding | Enable if you are in KSA and have MADA active on your account |
| Show Meeza Branding | Enable if you are in EGY and have Meeza active on your account |
| Mada Bins | New Mada BINs can be added as they are introduced. The latest BINs are supported by setting a default value for this field |
| Meeza Bins | New Meeza BINs can be added as they are introduced. The latest BINs are supported by setting a default value for this field |
Please do not change any of the configured BINs configuration unless it is instructed by Amazon Payment Services Integration team.
Apple Pay configuration
| Setting | Description |
|---|---|
| Enabled | Yes: Enables this payment option. No: Disables this payment option |
| SHA Type | Algorithm used by the plugin and Amazon Payment Services to verify requests and responses. Must match the Amazon Payment Services account |
| Apple Pay Button Types | Choose the type of Apple Pay button |
| Access Code | Obtain this value from the Amazon Payment Services account |
| Request SHA Phrase | Obtain this value from the Amazon Payment Services account |
| Response SHA Phrase | Obtain this value from the Amazon Payment Services account |
| Domain Name | The domain where OpenCart is running |
| Supported Networks | Select the card brands available for Apple Pay |
| Production Key | Password specified during Apple Pay certificate creation process |
| Apple Pay Certificates | Upload payment processing certificates received from Apple. Requires a certificate file and a certificate key file |
| Sort Order | On the checkout page, you can manage orders for all payment options |
If you have chosen Redirection integration type, Apple Pay will be displayed on the payment page, you do not need to do any Apple Pay configurations.
KNET configuration
Configure only if you are in KWT and have KNET payment option active on your Amazon Payment Services account.
| Setting | Description |
|---|---|
| Enabled | Yes: Enables this payment option. No: Disables this payment option |
| Sort Order | On the checkout page, you can manage orders for all payment options |
NAPS configuration
Configure only if you are in Qatar and have NAPS payment option active on your Amazon Payment Services account.
| Setting | Description |
|---|---|
| Enabled | Yes: Enables this payment option. No: Disables this payment option |
| Sort Order | On the checkout page, you can manage orders for all payment options |
Installments Configuration
| Setting | Description |
|---|---|
| Enabled | Yes: Enables this payment option. No: Disables this payment option |
| Integration Type | Choose from three integration types: Redirection: Users are redirected to Amazon Payment Services to enter payment details. Standard Checkout: Users stay on the merchant's checkout page; an Amazon Payment Services hosted form appears in an iframe. Hosted Checkout: Users stay on OpenCart, and the card form is hosted by OpenCart, with host-to-host communication between OpenCart and Amazon Payment Services |
| Installment Order Purchase Minimum Limit (SAR) | Default: 1100 SAR. The minimum order amount (including tax) required for installment purchases. Must match the installment plan threshold in Amazon Payment Services Back Office |
| Installment Order Purchase Minimum Limit (AED) | Default: 1100 AED. The minimum order amount (including tax) required for installment purchases. Must match the installment plan threshold in Amazon Payment Services Back Office |
| Installment Order Purchase Minimum Limit (EGP) | Default: 1100 EGP. The minimum order amount (including tax) required for installment purchases. Must match the installment plan threshold in Amazon Payment Services Back Office. Minimum order limits apply only to these three currencies, but installment plans may be available in others |
| Show Issuer Name | Check this box to display the bank/issuer name on the checkout page for installment plans |
| Show Issuer Logo | Check this box to display the bank/issuer logo on the checkout page for installment plans |
| Sort Order | On the checkout page, you can manage orders for all payment options |
In case of saved cards, the first 6 digits of saved (masked) card will be used to fetch installment plan.
valU configuration
Configure only if you are in Egypt and have valU payment option active on your Amazon Payment Services account.
| Setting | Description |
|---|---|
| Enabled | Yes: To enable this payment option. No: To disable this payment option |
| VALU Order | Minimum order limit in EGP. The total amount (including tax) required to place the order with Valu |
| Sort Order | On the checkout page, you can manage orders for all payment options |
Cron Jobs configuration
| Setting | Description |
|---|---|
| CRON Recurring Order | For recurring subscription payments |
| CRON Check Order Payment Status | Checks payment status for pending orders |
| CRON Check Status Duration | Time delay to determine which pending orders to check (e.g., 30 mins) |
Capture, Void & Refund
- Capture
- Void
- Refund
Full and partial captures are supported by following these steps:
Access Order Details
Go to the order detail page and navigate to the Amazon Payment Services tab under Order History section, enter the amount you want to capture.
Submit Capture
Click Capture.
- For a partial capture, enter an amount lower than the authorized amount.
- For a full capture, enter the exact authorized amount.
- Capturing more than the authorized amount is not allowed.
Void through your OpenCart admin panel by following these steps:
Access Order Details
Go to the order detail page and navigate to the Amazon Payment Services tab under Order History section, enter the amount you want to void.
Submit Void
Click Void.
Voiding more than the authorized amount is not allowed.
For refunds, OpenCart doesn't support refunds, our plugin is providing it.
Access Order Details
Go to the order detail page and navigate to the Amazon Payment Services tab under Order History section, enter the amount you want to refund.
Submit Refund
Click Refund.
- For orders placed with the Authorization command, refunds will only be available after the amounts are captured.
- Amounts greater than the captured amount cannot be refunded.
Test the integration
To test your integration with Amazon Payment Services plugin:
Add Product to Cart
Add a product to your cart.
Proceed to Checkout
Proceed to checkout and enter required details for checking out.
Test Payment
Pay by using one of our testing cards.
Visit this go-live checklist to go live with Amazon Payment Services plugin on OpenCart.