SuperAPI AI 工具集

setup-betterpay

编程与开发

查看项目

更新于 11-17 02:09

技能介绍

Betterpay(原QlicknPay、Pay Direct Technology)支付网关集成技能。

用途 用于Betterpay支付网关集成的设置、构建、调试、审查和解释工作。技能文档提供事实性API指引和集成代码编写前应阅读的参考材料。

主要能力 技能包含多份参考文档:betterpay-api.md覆盖PRO与LITE、环境与主机、认证、两种哈希算法、端点目录、标准支付与直接支付字段、回调、重查、退款、报告、支付链接、发票、速率限制、沙箱数据和错误;betterpay-recurring.md覆盖e-Mandate直接借记、OCBC收款批次或LITE卡定期扣款;betterpay-tokenization.md覆盖卡令牌、令牌扣款、批量扣款、令牌预授权或卡预授权(MPGS);betterpay-codes.md覆盖状态、错误、银行、渠道或枚举值;account-setup.md覆盖注册、密钥存放位置、API管理设置、沙箱与生产、环境变量、方法激活、插件或结算;source-map.md用于选择正确的官方文档锚点或Postman集合。

使用方式 核心工作流包括:根据商户ID识别产品(R前缀如R1001为LITE使用HMAC-SHA256;纯数字如10001为PRO使用MD5);识别环境(沙箱https://www.demo.betterpay.me或生产,需在登录后文档确认生产路径);识别接口表面(标准支付、直接支付、支付链接、账单、发票、定期扣款、令牌、预授权或插件);配置API管理(回调URL、白名单域名需匹配callback_url_be主机、返回URL);创建本地待处理订单(唯一发票号最多14字符且不含& ' -,金额为林吉特两位小数);服务端按端点精确字段顺序(PRO)或排序值规则(LITE)构建请求并计算哈希;通过表单POST发送浏览器(标准支付)或重定向到payment_url(直接支付且respond=1);将callback_url_fe_succ/ fail仅视为用户体验;在后端回调POST时验证哈希、检查发票金额和txn_status、幂等结算并回复纯文本OK;无回调或状态待定时通过Get Payment Status重查。

核心事实 Betterpay是QlicknPay栈更名而来,文档中Betterpay.me和qnp.com主机均有效,但多处仍写QlicknPay。文档位于https://www.betterpay.me/docs/(单页,端点在登录后),沙箱路径见https://github.com/betterpayme/POSTMAN-APIs。PRO生产主机据官方WP插件为https://www.betterpay.me,LITE插件结账为https://lite.betterpay.me/api/merchant/v1/checkout。认证使用merchant_id + hash在请求体中,API密钥仅用于签名,仅HTTPS,每个请求都需哈希。PRO标准哈希为md5(api|merchant_id|invoice|amount|payment_desc|currency);PRO回调检查为md5(api . trx_id . invoice_no . txn_status . msg)无分隔符,trx_id为fpx_fpxTxnId、paypal_trx_id、mastercard_trx_id或其他trx_id;部分PRO调用将merchant_id放在API密钥之前(重查、退款、退款状态)。LITE哈希为将所有发送字段除hash外按名称排序、拼接值、移除空格,然后hash_hmac('sha256', s, API_KEY),回调以相同方式对接收字段验证。状态码:PRO为00批准、09待定、99待授权(B2B);LITE为00成功、11失败、22待定、失败取消。金额限制为RM1.50最低、低于RM30,000(B2C),金额为两位小数字符串。回调重试最多3次每10分钟直到收到OK。GET端点共享每IP或账户每5分钟100次请求限制,超限返回HTTP 429 {"response":"99",...}。FPX退款API仅限自有FPX卖家ID,每请求最多10笔,5天内;DuitNow QR退款有独立端点。

关键规则 API密钥保留在服务端,绝不放入浏览器表单,哈希在服务端计算;绝不混用PRO与LITE哈希或端点,绝不混用沙箱与生产密钥;使用参考表中每端点精确字段顺序,绝不猜测;对发送的纯值计算哈希(PHP示例对每个值urldecode),金额以字符串发送;绝不从返回URL或客户端消息履约,仅从哈希验证的后端回调或重查履约;以恒定时间比较哈希,然后检查发票存在、金额与货币匹配、txn_status为成功码;回调处理器幂等,存储回调后始终回复纯文本OK,因重试和重复会发生;保持callback_url_be在白名单域名主机上,否则支付被拒绝("Invalid URL variable specified");每笔交易发票必须唯一,用相同发票重试会失败;将标记为"Not published"的端点和参考中文档/Postman冲突视为未确认,在沙箱测试并与支持确认。

适用场景与限制 适用于需要集成Betterpay支付网关的支付创建、回调处理、重查、退款、定期扣款、令牌化、账户配置和集成审查等任务。完成标准要求产品、环境、主机、商户ID和API密钥来自配置而非硬编码,支付创建与哈希在服务端按文档顺序或排序规则运行,API管理已配置正确环境的回调URL、白名单域名和返回URL,回调处理器验证哈希、检查发票金额货币和状态、仅结算一次并回复OK,待定结果和缺失回调通过Get Payment Status幂等解决,测试覆盖坏哈希、重放回调、错误金额、未知发票、失败/取消状态、待定状态和成功支付,部署文档列出BETTERPAY_PRODUCT、BETTERPAY_ENV、BETTERPAY_BASE_URL、BETTERPAY_MERCHANT_ID、BETTERPAY_API_KEY及回调/返回URL并区分沙箱与生产。技能还包含漏洞审查循环,用于在声称"100%自信"时检查信任边界、绕过和修复,并说明剩余不确定性,如生产端点路径(登录后)、LITE回调字段集、LITE支付链接哈希冲突、计划到产品映射、启用的渠道、退款资格、结算时机。未提供具体收费、价格或效果数据。