v1.0.0. | May 2017
Requires Magento: 1.9.3
The Alternative Payments Magento module allows for a seamless integration with our payment gateway. This module has been tested and is regularly maintained by Alternative Payments. If you notice any bugs, please let us know.
- Download the alternativepayments-magento.tgz file.
- Navigate to the Magento Admin panel.
- Navigate to "System", "Magento Connect", and "Magento Connect Manager".
- Go to Direct Package File upload
- Navigate to step 2, click "Choose File", select the Module file and click "Upload".
- After the Module is installed successfully, navigate back to "System"/"Configuration".
- Navigate to "Payment Methods".
- Navigate to "Alternative Payments".
- Enable your module
- Enter the Public API Key and Secret API Key obtained in the Website profile in the Alternative Payments Merchant Portal.
- Insert the API URL: https://api.alternativepayments.com/api
- Insert "Return URL" and "Cancel URL"
Default "Return URL": http://plugins.alternativepayments.com/message/success.html
Default "Cancel URL": http://plugins.alternativepayments.com/message/failure.html
- Please check your Merchant Portal Terms & Conditions for active payment options and select them in the Magento payment options list.
- Click "Save Config".
Creating webhooks for response data:
Go to ‘Merchant Portal > Business Cases > select Business Case ID > Websites section’
If no Website is added, click ‘Add new’ and complete the requested information.
Once in Website details, click on the tab ‘Webhooks’
Click ‘Add Webhook’
In field ‘Webhook url’ insert value:
[YOUR WEBSITE URL]/[MAGENTO ROOT FOLDER]/index.php/apayments/hook/index
Under Webhook Events, activate the following selections:
transaction.approved => Active
transaction.funded => Active
transaction.declined => Active
transaction.aborted => Active
void.succeeded => Active
void.declined => Active
refund.pending => Active
refund.succeeded => Active
refund.declined => Active
transaction.chargeback => Active
transaction.isf => Active
transaction.invalid => Active
It is essential only to enable the above Webhooks. Enabling unsupported webhooks will result in Magento not returning a successful response to the POST, causing the webhook to continue resending and eventually disable all webhooks for the site.
Change SEPA order status to proccessing when:
1/ Merchant Funded Status
2/ Merchant Approved Status
If SMS verification is enabled for SEPA payments:
When using Test API keys you can enter any phone number and enter 1234 as PIN. However, when using live API keys an actual mobile number that can receive the PIN needs to be used.