@ianmenethil/zp-hcp
v0.1.29
Published
ZenPay Hosted Checkout Plugin — zero-dependency modal/redirect payment integration with optional jQuery and Bootstrap backward compatibility
Maintainers
Readme
ZenPay Hosted Checkout Plugin
@ianmenethil/zp-hcp provides the ZenPay Hosted Checkout browser plugin plus v6 server helpers for fingerprint creation, callback verification, request validation, and callback URL state.
Start Here
| Need | Read | |---|---| | Browser checkout integration | BROWSER-USAGE.md | | Server fingerprint, callback verification, schemas, and token helpers | SERVER-USAGE.md | | What changed from v5 to v6 | V5-TO-V6.md |
Package Entries
| Import | Use |
|---|---|
| @ianmenethil/zp-hcp | Browser plugin: zpPayment(options).open() / .init() / .close() |
| @ianmenethil/zp-hcp/shared | Browser/server-safe constants, small helpers, and shared types |
| @ianmenethil/zp-hcp/server | Server-only fingerprint, callback verification, schemas, and token helpers |
Integration Boundary
| Boundary | Rule | |---|---| | Browser | Opens Hosted Checkout with a server-built payload. | | Server | Generates the fingerprint and verifies ZenPay callbacks. | | Callback | Treat the verified server callback as authoritative. Redirect query values are UI-only. |
Version Notes
| Migration | Purpose | |---|---| | V3-TO-V4.md | v3 JavaScript plugin to v4 TypeScript port. | | V4-TO-V5.md | v5 browser-plugin stabilization and fixes. | | V5-TO-V6.md | v6 browser, shared, and server package split. |
Project Notes
| File | Purpose | |---|---| | CHANGELOG.md | Release history. | | BUGS.md | Bug index and dispositions. | | BACKLOG.md | Deferred work. |
Source
The current implementation lives under src/v6/:
- root browser entry:
src/v6/zenpay.payment.v6.ts - shared entry:
src/v6/shared.ts - server entry:
src/v6/server.ts
Use the usage files above for import examples and integration flow details.
