Magento 2 ProxyPay Integration


Magento 2 ProxyPay Integration integrates Magento 2 with Angola's Proxypay payment gateway for receiving secure online payments in Kwanzas, the currency of Angola.


Table of Content

  1. Extension Installation
  2. Currency Setup
  3. Configuration
  4. ProxyPay Payment Method in Frontend
  5. ProxyPay Payment Details in Backend
  6. ProxyPay Admin Panel


  1. Extension Installation
  • Extract the zip folder and upload our extension to the root of your Magento 2 directory via FTP.
  • Log in to your SSH and run below commands step by step:
    • php bin/magento setup:upgrade
    • For Magento version 2.0.x to 2.1.x - php bin/magento setup:static-content:deploy
    • For Magento version 2.2.x & above - php bin/magento setup:static-content:deploy –f
    • php bin/magento cache:flush
  • That’s it.
  1. Currency Setup
    The very first step to configure the extension is currency setup if not already done. Make sure you set up Angolan Kwanza as the base currency as the ProxyPay Payment Gateway only works with Kwanza. To set up or change the base currency, go to Stores > Configuration > General > Currency Setup > Currency Options and set Base Currency as Angolan Kwanza.



  1. Configuration
    For configuring the extension, log in to Magento 2, move to Sales > Payments Methods > ProxyPay Integration where you can find various settings to enable the extension.


  • Enabled: Set “YES” to enable the payment method.
  • Title: Set the title for the payment method to be displayed in the frontend.
  • Show ProxyPay Logo: Set YES to show ProxyPay logo along with the payment method in the frontend.
  • Sandbox Mode: Select YES to enable sandbox mode.
  • Entity ID: Enter the entity ID provided by the ProxyPay while registration.
  • Key: Enter the key provided by the ProxyPay while registration.
  • Payment from Applicable Countries: Select countries to allow using this payment method.
  • Additional Information: Add additional information to show along with the payment method on the checkout page.
  • Sort Order: Enter Sort Order of the payment method display in frontend.



  1. ProxyPay Payment Method in Frontend
    Once the payment method is configured, ProxyPay Integration method is shown on the frontend while checking out the products. Just select the payment method and click to place order.



  • ProxyPay Details in “My Account” section
    Once the order is placed, the ProxyPay payment details are shown in the Account dashboard, in “My Orders” tab which includes entity ID and reference ID.



  1. ProxyPay Payment Details in Backend
    Apart from the customers, admin can also see the payment details for the orders in the backend. Go to Sales > Orders and you can see ProxyPay payment details under a particular order.


  • Payment Updates
    The extension runs a cron once in a day to request payment updates from the ProxyPay server. Once the cron is run, Magento gets the details of updated order payments and payment details are updated in each order successfully paid through Proxypay.


  1. ProxyPay Admin Panel
    Admin can see payment reference, order and customer details in the admin panel of the ProxyPay payment gateway. Simply log in to ProxyPay with your credentials and under the References, you can see all the payment details.


  • ProxyPay Payments
    Under the Payments tab of the ProxyPay admin panel, the admin can find the payment date, time, reference and other related details of an order.