QuadPay

QuadPay Integration

Welcome! Integrating QuadPay into your online store is straightforward. Here you'll find comprehensive guides and documentation to support integrating QuadPay into your site as quickly as possible. Let's jump right in!

Guides

Testing & QA

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 QuadPay as your payment method.
  5. Click Place Order.
  6. You will be redirected to the QuadPay hosted payment flow.
  7. Complete the QuadPay 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 QuadPay Merchant Portal to confirm this purchase appears as an Order.

📘

Merchant Portal

The QuadPay 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 configuration credentials.

FieldTest Data
PhoneA valid U.S. mobile phone number
EmailCan be real or fake valid email address (‘@example.com’ for fake)
Verification CodeCode received via SMS to valid U.S. mobile phone number
NameAnything
AddressAnything valid
BirthdateAnything 18+ years old
Billing AddressAnything valid
Card Holder NameAnything
Card Number4242 4242 4242 4242
Expiration date02 / 22
CVC222

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 QuadPay Merchant Portal (staging environment) to confirm this Order correctly reflects the refund.

📘

If the online store doesn't handle issuing refunds directly, the QuadPay 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 QuadPay 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 QuadPay 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 QuadPay 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 QuadPay 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 QuadPay checkout.

There are three use cases to test:

  1. Checkout with QuadPay and on a QuadPay 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 QuadPay and on a QuadPay Checkout screen (checkout.quadpay.com), close the browser. In the online store admin, the order status should be "Pending QuadPay." 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 QuadPay 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 QuadPay". After 10 minutes, the order status should be "Processing". This order should also appear in the QuadPay 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 QuadPay. Before going live, we verify that funds are captured, voided, and refunded as expected.

Browser Support

QuadPay 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

Updated about a year ago

Testing & QA


Suggested Edits are limited on API Reference Pages

You can only suggest edits to Markdown body content, but not to the API spec.