跳转到主要内容
阅读该接口文档前,务必先查看 接口说明

检查您的设备和浏览器设置

如果您在支付页面中看不到您想要的钱包,则您的设备或浏览器可能不符合以下 Apple Pay 或 Google Pay 条件。
  • 钱包里必须至少有一张卡。
  • 您必须使用兼容的 Apple Pay 设备Google Pay 设备
  • 您必须使用 必须使用HTTPS支持的浏览器 来测试您正在测试的钱包。
  • 允许适用的浏览器访问您的钱包。
    • Chrome:设置 > 自动填充和密码 > 付款方式 > 允许网站检查您是否已保存付款方式
    • Safari:设置 > 高级 > 允许网站检查 Apple Pay 和 Apple 卡
  • 不要使用 Chrome 隐身窗口或 Safari 私人窗口。
  • 确认您在受支持的 Apple Pay 地区 和 Google Pay 地区 进行操作。
  • 对于 Apple Pay,请确认您的设备支持生物识别身份验证

支持的浏览器

桌面浏览器

  • Chrome 38+
  • Safari 10.1+
  • Firefox 29+
  • Edge 15+
  • Opera 25+

移动浏览器

  • iOS Safari 9+ 以及其他使用系统提供的 WebKit 引擎的浏览器和 Web 视图
  • Android Chrome 38+
  • 三星浏览器 7.1+

其他说明

对于未明确支持的浏览器,我们限制支持如下:
  • 要求浏览器支持 TLS 1.2
  • 需要足够现代的浏览器来支持 JavaScript 中的 Promises
  • 我们会响应错误报告,但不会主动测试其他浏览器
::: danger 警告 以下地区禁止使用!!! ::: details 禁用地区列表 AD-安道尔 AE-阿拉伯联合酋长国 AF-阿富汗 AG-安提瓜和巴布达 AI-安圭拉 AL-阿尔巴尼亚 AM-亚美尼亚 AO-安哥拉 AQ-南极洲 AR-阿根廷 AS-美属萨摩亚 AW-阿鲁巴 AX-奥兰群岛 BA-波斯尼亚和黑塞哥维那 BB-巴巴多斯 BD-孟加拉国 BF-布基纳法索 BH-巴林 BI-布隆迪 BJ-贝宁 BL-圣巴泰勒米 BM-百慕大 BN-文莱 BQ-博内尔、圣尤斯特歇斯和萨巴 BS-巴哈马 BT-不丹 BV-布韦岛 BW-博茨瓦纳 BY-白俄罗斯 BZ-伯利兹 CC-科科斯(基林)群岛 CD-刚果民主共和国 CF-中非共和国 CG-刚果共和国 CI-科特迪瓦 CK-库克群岛 CM-喀麦隆 CO-哥伦比亚 CU-古巴 CV-佛得角 CW-库拉索 CX-圣诞岛 CY-塞浦路斯 DJ-吉布提 DM-多米尼克 DO-多米尼加共和国 DZ-阿尔及利亚 EC-厄瓜多尔 EE-爱沙尼亚 EG-埃及 EH-西撒哈拉 ER-厄立特里亚 ET-埃塞俄比亚 FJ-斐济 FK-福克兰群岛 FM-密克罗尼西亚联邦 FO-法罗群岛 GA-加蓬 GD-格林纳达 GE-格鲁吉亚 GF-法属圭亚那 GG-根西岛 GH-加纳 GI-直布罗陀 GL-格陵兰 GM-冈比亚 GN-几内亚 GP-瓜德罗普 GQ-赤道几内亚 GS-南乔治亚和南桑威奇群岛 GT-危地马拉 GW-几内亚比绍 HK-香港 HM-赫德岛和麦克唐纳群岛 HN-洪都拉斯 HT-海地 ID-印度尼西亚 IL-以色列 IM-马恩岛 IN-印度 IO-英属印度洋领地 IQ-伊拉克 IR-伊朗 JM-牙买加 JO-约旦 JP-日本 KE-肯尼亚 KH-柬埔寨 KI-基里巴斯 KM-科摩罗 KN-圣基茨和尼维斯 KP-朝鲜 KR-韩国 KW-科威特 KY-开曼群岛 KZ-哈萨克斯坦 LA-老挝 LB-黎巴嫩 LC-圣卢西亚 LI-列支敦士登 LK-斯里兰卡 LR-利比里亚 LS-莱索托 LV-拉脱维亚 LY-利比亚 MD-摩尔多瓦 ME-黑山 MF-法属圣马丁 MG-马达加斯加 MH-马绍尔群岛 MK-北马其顿 ML-马里 MM-缅甸 MN-蒙古 MP-北马里亚纳群岛 MQ-马提尼克 MR-毛里塔尼亚 MS-蒙特塞拉特 MU-毛里求斯 MV-马尔代夫 MW-马拉维 MY-马来西亚 MZ-莫桑比克 NA-纳米比亚 NC-新喀里多尼亚 NE-尼日尔 NF-诺福克岛 NG-尼日利亚 NI-尼加拉瓜 NP-尼泊尔 NR-瑙鲁 NU-纽埃 OM-阿曼 PA-巴拿马 PE-秘鲁 PF-法属波利尼西亚 PG-巴布亚新几内亚 PH-菲律宾 PK-巴基斯坦 PM-圣皮埃尔和密克隆 PN-皮特凯恩群岛 PR-波多黎各 PS-巴勒斯坦 PW-帕劳 RE-留尼汪 RU-俄罗斯 RW-卢旺达 SA-沙特阿拉伯 SB-所罗门群岛 SC-塞舌尔 SD-苏丹 SH-圣赫勒拿 SJ-斯瓦尔巴和扬马延 SK-斯洛伐克 SL-塞拉利昂 SM-圣马力诺 SN-塞内加尔 SO-索马里 SR-苏里南 SS-南苏丹 ST-圣多美和普林西比 SV-萨尔瓦多 SX-荷属圣马丁 SY-叙利亚 SZ-斯威士兰 TC-特克斯和凯科斯群岛 TD-乍得 TF-法属南部领地 TG-多哥 TH-泰国 TK-托克劳 TL-东帝汶 TM-土库曼斯坦 TN-突尼斯 TO-汤加 TR-土耳其 TT-特立尼达和多巴哥 TV-图瓦卢 TW-台湾 TZ-坦桑尼亚 UA-乌克兰 UG-乌干达 UM-美国本土外小岛屿 UY-乌拉圭 UZ-乌兹别克斯坦 VA-梵蒂冈 VC-圣文森特和格林纳丁斯 VE-委内瑞拉 VG-英属维尔京群岛 VI-美属维尔京群岛 VN-越南 VU-瓦努阿图 WF-瓦利斯和富图纳 WS-萨摩亚 YE-也门 YT-马约特 ZA-南非 ZM-赞比亚 ZW-津巴布韦 :::

限额

交易类型限额(单位:USD)
代收0.99-1000

代收API

代收申请

简要描述:
  • 创建代收订单
URL: 美元: /usd/collect/apply 说明:appId需使用美元对应的,用户支付成功后增加美元余额 参数:
参数名必选类型说明
appIdLong业务ID(后台获取,需要根据URL中的币种传递对应的业务ID)
orderIdString商户订单号(必须保证唯一性,长度不超过48)
nameString用户姓名,推荐使用真实姓名,格式:包含firstName和lastName,以空格分割的,示例:Donald John Trump
phoneString真实手机号(格式参考 电话号码格式
emailString真实电子邮件
amountString交易金额(精确到小数点后两位;禁止添加标点符号,例如:”,”)
payTypeStringEWALLET
inBankCodeStringAPPLE_PAY
callBackUrlString用户支付成功后跳转地址
callBackFailUrlString用户支付失败后跳转地址
notifyUrlString回调地址
subjectString支付备注
bodyString备注详情
partnerUserIdString用户唯一标识(如用户ID userId),用于风控系统,必须真实有效,否则会影响交易。 格式要求:数字、大小写字母或常用符号-~!@#$%&*()_。
signString签名
返回data参数说明
参数名类型说明
orderIdString商户订单号(必须保证唯一性)
orderNoString平台订单号
payUrlString支付链接
signString签名

代收查询

简要描述:
  • 查询代收订单
URL: 美元: /usd/collect/query 参数:
参数名必选类型说明
appIdLong业务ID(后台获取,需要根据URL中的币种传递对应的业务ID)
orderIdString商户订单号
orderNoString平台订单号(响应快)
signString签名
返回data参数说明
参数名类型说明
orderIdString商户订单号(必须保证唯一性)
orderNoString平台订单号
amountString交易金额
actualAmountString收到金额
feeString手续费
statusInteger状态(0未开始,1支付中,2成功(终态),3失败(终态), -1异常待确认)
payTimeString支付成功时间(当status=2时有值)(本地时间), 格式: yyyy-MM-dd HH:mm:ss
errorMsgString支付失败原因(当status=3时有值)
signString签名

HaiPaySDK 对接文档(Apple Pay & Google Pay)

HaiPaySDK 提供了便捷的 Apple Pay 和 Google Pay 支付集成方案,通过简单配置即可在网页中快速集成支付功能。
  <script src="https://cdn.jsdelivr.net/gh/hpth/payment/cashier/js/applePayGooglePay_1.0.0.js"></script>

  <div id="appId">
      <div id="applePay-googlePay"></div>
      <div id="error-message-pay"></div>
  </div

   const elements = new HaiPay({
        env: 'test',
        orderNo: '6cgjnxvc6kdb',
        buttonContainerId: 'applePay-googlePay',
        errorContainerId: 'error-message-pay',
        onCallback: (status) => {},
        onReady: () => {}
    });
    elements.createPay();
  • 参数说明
    • 1.初始化配置参数(HaiPay 构造函数参数)
参数名必选类型说明
envString环境类型,可选值 :
- test:测试环境(用于联调测试)
- prod:生产环境(上线使用)
orderNoString平台订单号
buttonContainerIdString支付按钮容器的 DOM ID, 无需携带 # 前缀
errorContainerIdString错误信息容器的 DOM ID, 无需携带 # 前缀
buttonTypeString按钮文本类型,默认值 buy, 可选值:
- plain:“只显示支付徽标,无文字”
- add-money:“添加资金”
- book:“预定”
- buy:“购买”(默认)
- check-out:“结账”
- contribute:“捐款”
- order:“下单”
- reload:“重新加载”
- rent: “租赁”
-subscribe: “订阅”
-support: “支持”
-tip: “付小费”
-top-up: “充值”
buttonThemeString按钮主题样式,默认值 black,可选值:
- black:黑色背景
- white:白色背景
buttonHeightnumber按钮高度,默认值 50
onCallbackfunction订单状态回调函数,参数为状态码:
- 成功:“2”/“4”/“5”
- 失败:“3”
onReadyfunction支付按钮渲染完成回调函数
  • 2.常见错误类型及解决方案
错误信息错误原因解决方案
Missing required parameters: env, orderNo缺少必需的初始化参数检查 env、orderNo 等参数是否传入
The env parameter must be test or prodenv 参数值非法将 env 改为 test 或 prod
Button container does not exist:#xxx支付按钮容器 ID 不存在确认支付地区是否在支持范围内,或切换至测试环境
Unsupported region: CN生产环境下不支持中国地区检查页面中是否有对应 ID 的 DOM 元素
Last modified on April 17, 2026