Zip Payments

This page provides an overview of the payments methods provided by the Zip Payments adapter in the IXOPAY platform. It also includes a full list of all configuration options available to you when integrating Zip Payments within your payments landscape, as well as an overview of the parameters required when submitting a transaction via IXOPAY's API.

Payment Methods

Payment Method	Transaction Flows	Transaction Types
Wallet	Full-Page Redirect	Debit, Preauthorize, Capture, Void, Refund

Additional Parameters

Wallet (Debit & Preauthorize)

Parameter	Type	Description
extraData.pickup	0 or 1	Whether this is a pickup order
extraData.trackingUri	string	URI to tracking page of shipment
extraData.trackingNumber	string	Tracking number of shipment
extraData.trackingCarrier	0 or 1	Carrier used for shipment
customer.extraData.title	true	Title of customer (Mr., Mrs. etc.)
item.extraData.type	sku, tax, shipping or discount	Type of item
item.extraData.item_uri	string	URI to product page
item.extraData.image_uri	string	URI to product image (thumbnail)

Mandatory Parameters

Wallet (Debit & Preauthorize)

Parameter	Required
items	true
customer.firstName	true
customer.lastName	true
customer.email	true
customer.billingAddress1	true
customer.billingCity	true
customer.billingPostcode	true
customer.billingState	true
customer.billingCountry	true

Integration through ZIP Widget

The integration from the Gateway works by default through the redirect flow from ZipPayments. You can also integrate by using ZIP's Widget solution ("Lightbox Checkout Library"), but you have to handle the Javascript part on your own. The Gateway returns you the following extraData values upon the initial Debit or Preauthorize call, which you will need for the ZIP Widget:

• zipId
• zipUri
• zipRedirectUri

You will have to use these values within the HTTP endpoint which is called by the ZIP Widget:

{
  "id": "value of extraData.zipId",
  "uri": "value of extraData.zipUri",
  "redirect_uri": "value of extraData.zipRedirectUri"
}