This page is a ZenPay-styled copy of the Zenith Payments developer documentation. View the original docs

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

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.

Related#

• 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