Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Info
titlePrerequisite alert!

1. Before you can begin offering zip payment options to your customers, your website must be running version 3.99+, and you'll need a merchant account with zip. Note that you can select between V1 and V2 of the API. 

2. Zip must also set up the webhook URL for you. It should be in the following format:

The feature will not work without this webhook.

...

  1. Contact your Zip Account Manager and ensure the webhook URL has been set up for your site (see info box above). Without this, orders will not integrate to your ERP.
    Do not proceed to step 2 until you have the webhook and confirmation that it's ready to use. 

  2. Gather your zip account credentials (i.e. your base and handover URLs and Authorisation Token).

  3. In the CMS, navigate to Settings → Feature Management

  4. Search for Buy Now, Pay Later, or select the Payment & Checkout tab.



  5. Click 'Configure' on the Buy Now, Pay Later feature.  (If no Configure option is visible, click the 'Contact to Enable' button and our support team will be notified of your request.)

  6. In the Provider Selection section, select either zipPay or zipMoney from the dropdown. At the time of writing, it is only possible to offer one or the other; not both.
     

  7. Select the API Version to be used for your site. Your site will be pre-configured with V1 but you can select to use V2. The fields will change depending on which option you choose.

  8. Set the Mode based on whether you're configuring zip for your Live site (Production), or Stage site (Sandbox).  


  9. Enter your Merchant IDs and Keys in the relevant fields (Production or Sandbox, depending on which of your sites you're configuring).  You can find these in your Zip Dashboard under Integration Details on the 'Settings' menu: 


    • Zip Merchant Unique ID = Public Key 

    • Zip Legacy API Key = Secret Key



  10. Set the following options: 

    • Event Logging - toggle this ON (recommended)

    • Auto-Integrate Pending Orders (zipMoney only) - integrates orders to the ERP prior to receiving a response from the payment provider.


  11. Display Content in Product Detail - toggle on to show the zip logo & info on the product detail page, which launches a pop-up explaining the details of the payment option.




  12. Disable Further Checkout Attempts with Provider for an Order if Declined - toggle on / off as required. 


  13. Set the Display Options as you require:
    • Min Price of Products to Show Content - the value of a product must meet this minimum in order for zip content to show on the detail page.
    • Max Price of Products to Show Content - the value of a product must not exceed this maximum in order for zip content to show on the detail page.
    • Min Order Total to be Available - the order total must meet this minimum in order for the customer to checkout with zip.
    • Max Order Total to be Available - the order total must not exceed this maximum in order for the customer to checkout with zip.



  14. Once all settings have been configured and you're ready to go, scroll back to the top and Save.

  15. Test the settings by clicking the Test Settings button. You will be informed whether the current settings are correct.



About Overrides

You can override any of the feature settings based on the user's role.

...