Authorize an Order

Plugin icon

Authorize an Order

Sent from the user's browser via a form POST, will start a checkout session within Zip. It will automatically redirect the user to our Zip checkout. You need to ensure you provide your merchant ID, merchant reference (the unique ID you use for the order in your system), confirm/cancel URLs, and the order amount. The order amount should include all shipping, tax, and discount charges. You do not need to provide the order ID as that will be generated for you. Passing as much customer information as possible will improve the user experience by pre-filling data fields and improving conversion. Required fields are:

  • merchantId - Your identifier provided by Zip
  • merchantReference - Your unique order identifier for this order in your system
  • callbackUrl - A URL that will receive the webhook request about the result of this operation
  • amount - The total amount of the order, including cart value, shipping, tax, and all fees
  • redirectCancelUrl - Where the user should go upon abandoning their cart
  • redirectConfirmUrl - Where the user should go upon order completion (will include the aforementioned query parameters)

Example:

Request URL: https://gateway.us.zip.co/orders/authorize
POST Body:

{
  "merchantId": "44444444-4444-4444-4444-444444444444",
  "merchantReference": "ref",
  "order": {
    "currency": "USD",
    "amount": 123.45,
  },
  "test": true,
  "capture": true,
  "redirectCancelUrl": "https://www.bing.com",
  "redirectConfirmUrl": "https://www.google.com",
  "callbackUrl": "https://api.merchant.com"
}

Authorize an Order (GET)

Same as the above endpoint but data is passed as query string parameters with a GET request.

Example:

Request URL: https://gateway.us.zip.co/orders/authorize?merchantId=44444444-4444-4444-4444-444444444444&merchantReference=TH-20200707-1da6&order.firstName=Aaron&order.lastName=Smith&order.email=869765666.test%40quadpay.com&order.phone=5555555555&order.billingAddress.line1=123+Main+St&order.billingAddress.city=New+York&order.billingAddress.state=NY&order.billingAddress.postalCode=10003&order.billingAddress.country=US&order.amount=100.00&capture=True&callbackUrl=https%3a%2f%2fapi.merchant.com%2forder%2fcomplete&redirectCancelUrl=https%3a%2f%2fapi.merchant.com%2forder%2fcancel&redirectConfirmUrl=https%3a%2f%2fapi-ci.quadpay.com%2forder%2fcomplete&X-QP-Signature=3f3oc6tACuGIs%2fX7bhWP3PkstZ8UmI6fSZ%2buPQE8Wfo%3d