SuperAPI AI 工具集

drop-in-ui

编程与开发

查看项目

更新于 10-15 22:13

技能介绍

用途:通过 HitPay.js 在网站中以模态弹层嵌入 HitPay 托管结账界面,适合二维码类支付方式(PayNow、GrabPay、ShopeePay 等),无需 PCI 范围。卡片支付、Apple Pay、Google Pay 建议改用重定向结账流程。

主要能力:引入脚本后,服务端创建支付请求并返回支付 URL,客户端调用 window.HitPay.init(url, options) 初始化,再用 window.HitPay.toggle({open:true}) 打开弹层。init 选项含 domain、apiDomain(生产为 hit-pay.com / api.hit-pay.com,沙箱为 sandbox.hit-pay.com / api.sandbox.hit-pay.com),以及 onSuccess、onError、onClose 回调。onSuccess 返回 payment_request_id、status、reference_number。

使用方式:生产环境引入 https://hit-pay.com/hitpay.js,沙箱引入 https://sandbox.hit-pay.com/hitpay.js;Next.js 可用 next/script。服务端向 /v1/payment-requests 发起请求,携带 X-BUSINESS-API-KEY 头,传 amount、currency、email、reference_number、redirect_url、webhook。

限制:卡片不推荐(3DS 弹窗在模态内不可靠);不支持 Apple Pay / Google Pay;样式仅可定制颜色和 logo;移动端为全屏覆盖;同一时间仅一个模态,重复 init 会替换会话;使用 CSP 时需允许 frame-src。onSuccess 为客户端回调,可被伪造,必须通过 webhook 验证后再履约。环境变量示例:HITPAY_API_KEY、HITPAY_SALT、HITPAY_ENV、NEXT_PUBLIC_HITPAY_ENV、NEXT_PUBLIC_APP_URL。