Skip to main content
Version: 0.0.1

Hosted Checkout

Hosted Checkout is ZenPay's integrated checkout solution. Your frontend initialises the JavaScript Plugin (zpPayment(...)) using values prepared by your backend, then launches the ZenPay-hosted payment experience either in a modal iframe or via full-page redirect.

  • the plugin is the launcher
  • the hosted checkout page is the payment UI
  • your backend is the source of trust

Payment plugin demo

What's in this section​

Hosted Checkout Pathway​

What Hosted Checkout is, the payment journey, and the trust model.

Building the Payload​

Configuration choices through generating the fingerprint.

Input and Output Parameters​

Input and output parameter reference tables.

Full Worked Example​

Complete backend and frontend example, with a link to the live sandbox.

Configuring Payment Types​

Payment method configuration — Cards, PayTo, Apple Pay, and more.

Callbacks and Handling the Customer's Return​

Callbacks, payload reference, callback validation, and handling the customer's return.

Plugin Errors and Troubleshooting​

Troubleshooting checklist, error codes, and common error codes.

Best Practices / Hardening Your Integration​

Best practices for hardening your integration.

Playground​

Interactive test page — experiment with plugin options without building a full integration first.

  • Payment Links → hosted link-based payments (no integration required)
  • REST API → backend-only payment operations
  • Developer Tools → debugging and validation tools
  • Payment Methods → what each method is and where it's supported
Last updated on by Ian Menethil