SuperAPI AI 工具集

hitpay

前端与建站

查看项目

更新于 10-16 05:51

技能介绍

用途:在 Next.js 及 JS/TS 应用中集成 HitPay 支付网关,适合 APAC 业务。可处理创建收银台流程、卡支付跳转、嵌入式 QR 支付(PayNow、GrabPay、ShopeePay 等)、webhook 回调、退款。

主要能力:先确定支付方式,卡类(Visa、Mastercard、Amex)推荐跳转 HitPay 托管收银台;QR 类(paynow_online、grabpay_direct、shopee_pay、wechat、alipay、fpx、promptpay、truemoney、vietqr、qris、upi、gcash)在站内嵌入二维码;两者都支持时可加支付方式选择器。API 沙箱基址 https://api.sandbox.hit-pay.com,生产 https://api.hit-pay.com,认证用 X-BUSINESS-API-KEY 请求头,密钥在仪表盘 Settings → Payment Gateway → API Keys 获取。

使用方式:后端调用 /v1/payment-requests 创建支付请求,卡支付流程返回 url 供前端跳转,二维码流程传 generate_qr: true 并用响应中的 qr_code_data 渲染二维码;通过 /v1/payment-requests/{id} 查询状态,/v1/payment-requests/{id}/refund 发起退款。webhook 必须校验签名,用 HITPAY_SALT 对原始请求体做 HMAC-SHA256 后与 Hitpay-Signature 头比对,仅当 status 为 completed 时才标记订单已支付。环境变量包括 HITPAY_API_KEY、HITPAY_SALT、NEXT_PUBLIC_APP_URL。沙箱测试卡:成功 4242 4242 4242 4242,失败 4000 0000 0000 0002。

适用场景:需要在新加坡等亚太地区收款、希望由 HitPay 托管收银台或站内二维码收款的 Web 应用。

限制:资料未提供收费、价格、平台支持范围、结算周期和具体费率信息;正式使用需自行确认合规与密钥安全,且务必保留 webhook 验签。