Our app is now available on iOS and Android

  • Search

    Magento 2 Integration Steps

    Download File app

    Locate Your Zip Merchant Credentials

    To integrate Zip into your Magento 2 website, you will need the following Zip Merchant Credentials:

    – Client ID

    – Client Secret

    These credentials should have been sent to you by email, however, if you’re unable to locate them, please contact us at nz@partners.zip.co


    Add Zip as a Payment Method

    Download the Zip Extension file provided by us

    – Copy and paste the Magento 2 plugin folder ‘MR’  into:

    %magento2%/app/code

    – Run the following commands via command prompt:

    cd %magento2%

    php bin/magento setup:upgrade

    php bin/magento setup:staticcontent:

    deploy


    Configure the Plugin Settings

    – In the left-hand side menu, navigate to Stores > Configuration > Sales > Payment Methods

    – Find MR Zip Payment Method

    – Enter the following values into the fields:

    Variable/Field Value
    Enabled Yes
    Client ID <Provided by us>
    Client Secret <Provided by us>
    API Endpoint Production: https://zip.co/nz/api/

    Sandbox*: https://zip.co/nz/ci/api/

    Auth Token Endpoint Production: https://merchant-auth-nz.zip.co/oauth/token

    Sandbox*: https://merchant-auth-sandbox.partpay.co.nz/oauth/token

    API Audience Production: https://auth.zip.co.nz/

    Sandbox*: https://auth-dev.partpay.co.nz

    Debug Mode Yes – Enables daily detailed log files
    Merchant Name You can keep this blank or fill it in for your own reference

    *For testing, different client credentials must be used. Please contact our team at nz@partners.zip.co for further information


    Adding the Zip Widget to the Product Page

    The widget should be ready to go once the plugin has been configured correctly

    If you wish to change the widget position – you can work with the layout file below:

    %M2_root_path%/app/code/MR/Zip/view/frontend/layout/catalog_product_view.xml


    Adding the Zip Widget to the Cart Page

    The widget should be ready to go once the plugin has been configured correctly

    If you wish to change the widget position – you can work with the layout file below:

    %M2_root_path%/app/code/MR/Zip/view/frontend/layout/checkout_cart_index.xml


    Adding the Zip Payment Icon

    What does the Zip payment icon look like?

    – In the Magento admin dashboard, navigate to Content > Blocks

    – Select the footer block that contains your other payment icons/logos

    – Select ‘HTML’ and use the following code on top of the ‘</ul>’ tag on the bottom

    <a><img src=”https://d3k1w8lx8mqizo.cloudfront.net/INTEGRATIONS/2016/zippay/payment-icons/zip-paycon-80×50-greyscale.png” style=”height:30px”></a>

    This will add the Zip Payment Icon alongside the other accepted payment method logos.

    Note: If required, you can change the value of the height style property to adjust the size of the Zip icon.

     

    – Save your changes

    Zip Co NZ Limited, Level 3, 33-45 Hurstmere Road, Takapuna, Auckland.

    09 489 8144 nz@care.zip.co