SuperAPI AI 工具集

setup-asiapay

编程与开发

查看项目

更新于 11-17 02:09

技能介绍

用途:本技能面向 AsiaPay(PayDollar)马来西亚支付网关的集成工作,可协助搭建、构建、调试、审查和解释相关集成。需注意,AsiaPay Malaysia 销售的是 PayDollar 网关,API、主机和字段名均沿用 PayDollar(paydollar.com);SiamPay 与 PesoPay 属于同一平台的泰国和菲律宾品牌,不在本技能范围内。

参考资料:在提供事实性 API 指导或编写集成代码前,应先阅读 references/asiapay-api.md,其中包含端点目录、测试与正式 URL、支付请求字段、secureHash 字符串顺序、datafeed 字段、Merchant API 输入输出、状态值、响应码、测试卡及常见陷阱。当用户询问注册、商户 ID、Secure Hash Secret 或 API 登录位置、如何启用 datafeed 或 secure hash、沙箱与正式账户、马来西亚支付方式开通或定价时,应阅读 references/account-setup.md。references/source-map.md 用于选取正确的官方页面,或查看文档覆盖与未覆盖的内容。

主要能力与工作流:识别环境(测试 test.paydollar.com/b2cDemo 或生产 www.paydollar.com/b2c2);选择连接方式(Client Post Through Browser 浏览器托管页、Direct Client Side Connection 商户卡表单需 PCI 范围、Server Side Direct Connection 服务端提交、PaySDK 移动端);确认后台配置(Secure Hash 已由 AsiaPay 启用、已复制 Secret、datafeed URL 已启用、Merchant API 登录已签发、支付方式已激活);在向 PayDollar 提交前创建本地待处理订单并生成唯一 orderRef;服务端构建表单,包含 merchantId、orderRef、currCode=458、amount、payType、payMethod、lang、三个 URL,以及 secureHash = SHA(merchantId|orderRef|currCode|amount|payType|secret);由浏览器自动提交表单至 payForm.jsp,successUrl、failUrl、cancelUrl 仅用于展示;接收 datafeed POST 后先输出 OK,再以 src|prc|successcode|Ref|PayRef|Cur|Amt|payerAuth|secret 校验 secureHash;仅当哈希、MerchantId、Ref、Amt、Cur 与 successcode=0 全部匹配时幂等结算;datafeed 缺失或 successcode=2 时用 Merchant API actionType=Query 查询;退款与撤销通过 onlineApi.jsp(OnlineReversal)或 orderApi.jsp(Void、RequestRefund)在服务端执行。

关键事实:测试托管页为 https://test.paydollar.com/b2cDemo/eng/payment/payForm.jsp,正式为 https://www.paydollar.com/b2c2/eng/payment/payForm.jsp;Server Side Direct 为 .../eng/directPay/payComp.jsp,Direct Client Side 为 .../eng/dPayment/payComp.jsp;Merchant API 为 .../eng/merchant/api/orderApi.jsp,在线撤销/退款为 .../eng/merchant/api/onlineApi.jsp,结算报告为 .../GenTxnXML。所有请求均为 application/x-www-form-urlencoded POST,UTF-8,字段名区分大小写。MYR 货币代码为 458,一个商户 ID 仅接受一种货币。amount 以林吉特计、最多两位小数,不是分。请求哈希默认 SHA-1,账户可设 SHA-256。启用 Secure Hash 后无有效哈希的请求会被丢弃,Secret 每两年轮换。successcode 取值为 0 成功、1 失败、2 待处理。datafeed 页面必须输出 OK,仅支持 80 与 443 端口。Merchant API 认证为 merchantId + loginId + password 放在 POST body 中。Hold 支付(payType=H)须在 14 天内捕获。测试商户 ID 为 6 位,生产为 4 或 8 位。

使用限制与注意:Secure Hash Secret、API loginId 与 password 仅保留在服务端,哈希须在服务端计算;须对实际提交的金额字符串做哈希;不得仅凭跳转 URL 或 PaySDK 客户端结果标记已支付;校验 datafeed 哈希应使用原始 POST 值并在类型转换前进行,以常量时间比较;先输出 OK 再处理,避免重复重试无法去重;同一 orderRef 可能收到多个 datafeed,已支付后忽略后续失败;successcode=2 及 Pending 状态非最终结果;不得混用测试与生产配置;不得存储卡号、有效期或 CVV,直连卡提交会将商户纳入 PCI 范围。完成标准包括:表单服务端构建且哈希正确、跳转页仅展示状态、datafeed 可达并校验通过、结算幂等、缺失或待处理时用 Query 回查、测试覆盖异常场景、部署文档列出各环境变量与 URL。文档依赖商户账户确定的剩余不确定项包括:哈希算法、已开通支付方式及其 payMethod 代码、退款窗口、datafeed 重试设置、生产 PaySDK 主机。