We recommend first integrating in a test or staging environment and then integrating in the production environment. The below steps can be used to test or QA the integration.

Test the Payment Gateway

1. Visit the online store.
2. Add items to the cart.
3. Complete the checkout process (enter any name, email, phone, and address).
4. Select Zip as your payment method.
5. Click Place Order.
6. You will be redirected to the Zip hosted payment flow.
7. Complete the Zip Checkout Process. If you are using a staging environment and staging configuration credentials, use the below Test Data.
8. Click Confirm Payment.
9. You will be redirected back to your online store site after a successful checkout and see the order confirmation screen.
10. Visit the Zip Merchant Portal to confirm this purchase appears as an Order.

📘

Merchant Portal

The Sandbox Zip Merchant Portal is available for test/staging and production environments. Please contact [email protected] if you have any questions on credentials for the Merchant Portal.

Test Data

❗️

This test data is only valid if you are using a staging environment with staging integration credentials.

Test Refunds

1. In the online store's admin tool, locate the order you would like to issue a refund for.
2. Issue the refund following the same steps typically used to issue refunds for other payment platforms.
3. In the online store's admin tool, verify the order status updates to reflect the refund.
4. Visit the Zip Merchant Portal (staging environment) to confirm this Order correctly reflects the refund.

📘

If the online store doesn't handle issuing refunds directly, the Zip Merchant Portal can be configured to issue refunds. Contact [email protected] to learn more.

Test the Widget

For each screen the widget appears on, usually the Product Details Page, Cart, and Mini Cart:

• Ensure the widget meets Zip Widget Style Guidelines on desktop, tablet, and mobile.
• Locate a product with variable prices and verify the QuadPay Installment Price updates when the Product Price updates.
• When products are in the cart, adjust the quantities of products and verify the Zip Installment Price updates when the Cart Total updates.
• Click on the "Learn More" link and verify the informational modal appears.
• Locate a product that is under the Zip Minimum Amount and verify the alternative "or 4 interest-free payments on orders over ${minimum-price}" text appears.
• Add products to the Cart so that the Cart Total exceeds the Zip Maximum Amount and verify the alternative "or 4 interest-free payments on orders up to ${maximum-price}" text appears.

Test Pending Orders

To account for edge cases where a customer does not get successfully redirected back to the online store (due to a network or other unexpected interruption), the online store's internal order status should be updated to reflect the outcome of the Zip checkout.

There are three use cases to test:

1. Checkout with Zip and on a Zip Checkout screen (checkout.quadpay.com), click the "Back to Cart" link. In the online store admin, the order should be treated as an abandoned cart and not appear in the orders list after about 10 minutes.

2. Checkout with Zip and on a Zip Checkout screen (checkout.quadpay.com), close the browser. In the online store admin, the order status should be "Pending Zip." After more than 60 minutes, the order should be treated as an abandoned cart and not appear in the online store admin.

3. Checkout with Zip and after clicking the "Confirm Payment" button, close the browser before being redirected back to the online store. In the online store admin, the order status of this successful order should be "Processing" or "Pending Zip". After 10 minutes, the order status should be "Processing". This order should also appear in the Zip Merchant Portal.

📘

International Partners

If a valid U.S. mobile number is not readily available, a Google Voice number can be used for testing.

Test "Pay on Ship"

Some online stores take a "pay on ship" approach to capturing funds. Instead of capturing funds immediately, the funds are captured at the time of invoice or shipment. This approach requires a customized integration with Zip. Before going live, we verify that funds are captured, voided, and refunded as expected.

Browser Support

Zip currently supports the latest two versions of these browsers, unless otherwise noted:

Google Chrome

• Mozilla Firefox
• Apple Safari
• Microsoft Edge
• Internet Explorer 11
• Apple Safari for iOS
• Google Chrome for Android

Go Live

Once your integration is complete and your testing has been completed, you will need to point to the production endpoints and use your live API keys.

🚧

Live Testing

If you require a production test and do not have a Zip account, please reach out to the team and we can organise a test transaction.