Overview
Important - This help page refers to zip's v1 API settings. Note that the latest version (V2) is currently supported by Commerce Vision. V2 does not distinguish between zipMoney and zipPay. See documentation on zip V2.
zipPay and zipMoney are popular Buy Now, Pay Later options that Commerce Vision supports for BPD. Your customers can get their goods now, and pay for them over time in manageable instalments. Configuring zipPay / zipMoney for your website is quick and easy, provided you have already established a merchant account with zip. For further information see our comparison page, or visit zip at https://zip.co/.
Prerequisite alert!
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.
- For V1, Zip must also set up the webhook URL for you. It should be in the following format:
ZipPay - https://www.yourwebsite.com.au/api/zipwebhookhandler/zip?mode=pay
ZipMoney - https://www.yourwebsite.com.au/api/zipwebhookhandler/zip?mode=money
The V1 API will not work without this webhook.
Step-by-step guide
- 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.- Gather your zip account credentials (i.e. your base and handover URLs and Authorisation Token).
- In the CMS, navigate to Settings → Feature Management → Payment & Checkout.
- Toggle ON Buy Now, Pay Later, then click Configure.
- Select the Zip tab.
- In Zip Provider, select either ZipPay or ZipMoney.
- For API Version , select V1. Note - if your site is already using V1, this option will remain after any CSS upgrade.
- Set the Mode based on whether you're configuring zip for your Live site (Production), or Stage site (Sandbox).
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:
Production Merchant Unique ID = Public Key
Production Legacy API Key = Secret Key
- 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.- Once all settings have been configured and you're ready to go, scroll back to the top and Save.
- Test the settings by clicking the Test Settings button. You will be informed whether the current settings are correct.
Set Display Options
Display Options determine where and how zipPay/zipMoney appears on your site.
- Set the Display Options as you require:
Display Content in Product Detail - toggle ON to show the zip logo, tag line and link on the product detail page.
Disable Further Checkout Attempts with Provider for an Order if Declined - toggle on / off as required.
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.
Use CV Zip Content - Default is OFF. When off, zip content on the product page and in checkout pages come directly from zip. 'OFF' is recommended so that your site displays Zip's latest information. IMPORTANT - Contact zip as this option requires assistance from zip.
If this option is ON, default Zip content stored in BPD is displayed instead. Note - you can edit the tag line and link text in the Product Purchase Payment Widget.
Adding Overrides
You can override any of the display feature settings based on the user's Role.
For example, you may wish to display the zip info box on the Product Detail page for B2C users, but not for B2B. In this case, you could set an override.
- Select the 'Overrides' icon next to the setting you want to customise.
- A popup will open, with your current Global setting displayed at the bottom. Click Add Override Setting in the Role Overrides section.
- Enter the role name into the lookup and select the role from the options presented.
- Set the role override value for this setting.
- Click Confirm to close the window.
- Don't forget to click Save on the feature settings page to save your changes!
Additional Information
| Minimum Version Requirements | 3.99.00 |
|---|---|
| Prerequisites | Merchant account with zip |
| Self Configurable | Yes |
| Business Function | Marketing, Finance |
| BPD Only? | Yes |
| B2B/B2C/Both | B2C |
| Ballpark Hours From CV (if opting for CV to complete self config component) | Contact CV Support |
| Ballpark Hours From CV (in addition to any self config required) | Contact CV Support |
| Third Party Costs | Refer to zip T&Cs |
| CMS Category | Settings → Feature Management |
Related help