SuperAPI AI 工具集

payment-integration

编程与开发

查看项目

更新于 10-15 22:13

技能介绍

用途:在 Next.js 与 JS/TS 应用中集成 HitPay 支付网关,面向亚太地区业务,支持卡支付、二维码支付与嵌入式结账。

主要能力:卡支付(Visa、Mastercard、Amex)通过跳转至 HitPay 托管页完成;二维码支付支持 paynow_online、grabpay_direct、shopee_pay、wechat、alipay、fpx、promptpay、truemoney、vietqr、qris、upi、gcash;另提供 HitPay Drop-In UI 一体化结账(见 drop-in-ui 技能)。

使用方式:API 基础地址沙箱为 https://api.sandbox.hit-pay.com,生产为 https://api.hit-pay.com;请求头使用 X-BUSINESS-API-KEY 与 Content-Type: application/json,密钥在 HitPay 后台 Settings > Payment Gateway > API Keys 获取。前端方案按支付方式选择:仅卡用跳转,仅二维码用站内嵌入二维码,两者兼有用支付方式选择器,完整结账用 Drop-In UI。后端创建支付请求后,跳转方案将用户重定向至 response.url;二维码方案设置 generate_qr: true 并渲染 response.qr_code_data,前端轮询状态或等待 webhook。webhook 需用 HITPAY_SALT 做 HMAC-SHA256 验签后再处理,可通过 GET /v1/payment-requests/{id} 查询支付状态。环境变量包括 HITPAY_API_KEY、HITPAY_SALT、NEXT_PUBLIC_APP_URL。

适用场景:Next.js 电商结账页、订阅或一次性收款、亚太本地支付方式接入。

限制:资料未提供具体费率、结算周期、支持币种范围及生产环境上线要求,需以官方文档为准;沙箱测试卡号仅用于测试。