Skip to main content

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 MethodTransaction FlowsTransaction Types
WalletFull-Page RedirectDebit, Preauthorize, Capture, Void, Refund

Additional Parameters

Wallet (Debit & Preauthorize)

extraData.pickup0 or 1Whether this is a pickup order
extraData.trackingUristringURI to tracking page of shipment
extraData.trackingNumberstringTracking number of shipment
extraData.trackingCarrier0 or 1Carrier used for shipment
customer.extraData.titletrueTitle of customer (Mr., Mrs. etc.)
item.extraData.typesku, tax, shipping or discountType of item
item.extraData.item_uristringURI to product page
item.extraData.image_uristringURI to product image (thumbnail)

Mandatory Parameters

Wallet (Debit & Preauthorize)


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"