Redirect buyer for purchase approval
DocsLimited
Last updated: Oct 24th, 2:36am
- After you create the order, extract the
payer-actionlink from thelinksarray in the Create order response. - Set your Zip payment button to open this URL when clicked. This sends the buyer to Zip's Hosted Payment Page (HPP).
- The buyer logs into their Zip account and reviews the payment schedule (Pay-in-4 instalments or credit options).
- If the buyer approves the payment:
- Upon approval, PayPal automatically captures the full payment amount immediately.
- The buyer is redirected to your
return_url - The
PAYMENT.CAPTURE.COMPLETEDwebhook is triggered, confirming that the payment has been successfully captured.
- If the buyer cancels or an error occurs:
- The buyer is redirected to your
cancel_url. - Order status remains
PAYER_ACTION_REQUIRED.
- The buyer is redirected to your
- If the buyer approves the payment:
Note: Zip sessions have different timeout periods by market. In the US, sessions expire after 10 minutes. In Australia, sessions have an extended timeout of 168 hours (7 days). If the buyer doesn't complete approval within these windows, the session expires, and the buyer is redirected to your cancel_url.