線上遷移機構/商家側有感點

版本信息

版本號

描述

生效時間

v1.1

初始版本

2025.08.04

背景介紹

為配合監管要求AlipayHK後台系統需要進行遷移,香港站的商家(線上場景)需於最早 2025年9月15日開始遵循以下變更點使用相應的服務。

下文将詳細描述遷移後的體驗變動。整體而言,有以下事項需要注意:

  • 升級AlipayHK提供新門戶入口。
  • 不變AlipayHK將統一進行結算打款、提供結算文件。
  • 不變機構/商家目前使用的大部分線上接口可繼續使用,不可用接口詳見下文。
  • 變更由於系統升級後舊門戶结算/待结算/交易數據或存在不準確的情況,相關信息請使用新門戶查詢
  • 臨時沙箱環境維持現在集成接入方式

*機構/商戶側如對AlipayHK接口回傳值有特殊處理,例如驗證回傳參數數目、限制回傳值字節長度、僅處理現有枚舉值等,請參考下列變列表做詳細分析,以免切流或遷移後影響機構/商戶下游系統的處理

可感知點列表

類別

線上系統遷移

PID維度切流後即使用新系統

HK&CN錢包

A. 商戶門戶

A.1. 商戶賬號管理

A.1.1. 門戶登錄

不變機構/商戶仍然可以使用現有賬密登錄老門戶。 老門戶現有功能維持不變。但考慮到舊門戶结算/待结算/交易數據或存在不準確的情況,相關信息請使用新門戶查詢。

升級新門戶已上線,機構/商戶可以使用現有帳戶登錄新門戶,無需重新註冊。

*首次登陸新門戶需要重置密碼,並通過郵箱接收驗證碼。 請確保登錄郵箱可用且能夠接收驗證碼資訊

A.1.2. 合約確認

不變如有合約簽署或變更,機構/商戶仍然可以在老門戶對合約確認

A.1.3. 帳號資訊更改,包括登入密碼,郵箱及付款密碼

不變機構/商戶仍然可以使用現有老門戶對賬號進行維護

*新老門戶的賬密不會自動同步,在老門戶上對帳戶資訊的更改不會影響新門戶的賬號資訊

不支持登錄新門戶的帳號信息暫時不支援機構/商戶自助更改。 如有更改需要,請聯繫 HKMerchant@alipay.com

*新老門戶的賬密不會自動同步,對新門戶上帳戶資訊的更改不會影響老門戶

*門戶系統功能將陸續更新,升級后將支援該能力。

A.1.4. 查看/更改密鑰資訊

變更機構/商戶不能在新老門戶進行查看或更改RSA,RSA2密鑰資訊,不支持查看及修改MD5。

*如需查看/更改RSA/RSA2密鑰請聯繫 AlipayHMTtechsupport@service.alipay.com

A.1.5. 查看PID資訊

不變機構/商戶仍然可以使用現有老門戶查看PID資訊

A.2. 交易資訊

A.2.1. 查看交易記錄,包括交易類別、狀態、金額

不變機構/商戶仍然可以使用現有老門戶查看切流前的交易資訊。切流後的交易請使用新門戶查看。

A.2.2. 查看結算資訊

不適用 結算資訊將統一至新門戶上可查。

A.2.3. 操作退款

不變機構/商戶仍然可以使用現有老門戶執行退款操作。切流後的交易請使用新門戶執行退款操作。

A.3. 文件下載

A.3.1. 結算及交易

變更由於系統升級後,老門戶的數據或存在不準確的情況,故建議機構/商戶後續如有需要,請使用新門戶下載賬單

A.3.2. 交易詳情

變更機構/商戶暫時無法通過新門戶下載交易詳情文件。 但可以查看所有交易的詳情

B. 財務運營

B.1. 帳單

B.1.1 結算交易帳單

不變SFTP內的交易結算帳單維持現有格式、發放渠道。 SFTP的登錄帳密不變.

(登錄SFTP請使用新域名 https://isftp-sea.alipayplus.com

B.1.2 ISV返傭帳單

不變現有接收返傭帳單的渠道保持不變

升級可以通過新門戶下載返傭帳單

*需要使用ISV角色的主PID賬號登錄

B.2. 結算

B.2.1 結算限額

臨時內部切流需要,在切流期間將臨時調整結算限額。 切流完成後將恢復正常額度。 ( 預期受影響時間為切流前後2-3日)

C. 技術

C.1. 秘鑰更新

( 參考上文 A.1.4. )

變更機構/商戶不能通過門戶對RSA2秘鑰進行更改。 如需更改請聯繫 AlipayHMTtechsupport@service.alipay.com

C.2. 支付/查詢/退款接口

C.2.1 接口類別

不變現有接口均可用

*仍然不支援CNY等非HKD幣種下單

C.3. 文件下載接口

C.3.1. 交易賬單下載接口

forex_compare_file

變更僅支持查詢T-1日的數據(T為交易日)

T日凌晨02:00產出T-1日的交易文件,建議02:00之後調用接口獲取文件,否則調用時會報錯。

結算時間(column5)將不再返回,結算狀態(column8)將恆常返回 "P" (已付款)(2025/09/15 生效)

C.3.2. 結算賬單下載接口

forex_liquidation_file

變更調用錯誤(2025/07/20 生效)

C.3.3. 匯率文件下載接口

forex_rate_file

變更調用錯誤(2025/07/20 生效)

C.7. 沙箱環境

不變保持不變

常見問題

遷移期間,商戶交易是否有影響?

沒有影響。本次升級為AlipayHK 後台升級,對機構/商戶側是幾乎無感的,升級期間無服務中斷。有感點請參照上文。有感點集中在商戶門戶及部分接口的返回字段上。

存量商戶需要重新報備?

不需要。

我如何知道我的PID已經完成遷移?

現階段AlipayHK將以PID為維度逐步完成遷移。請注意,遷移的前提是您的PID請求的域名已經不再是舊域名。舊域名包括:http://mapi.alipay.com/ http://www.alipay.com http://mapi-hk.alipay.com。如仍在使用舊域名,請盡快升級至新域名:https://api-sea-global.alipayplus.com

預期的升級時間為2025年Q3。如有任何疑問,請聯繫我們的集成團隊查詢及處理hk_integration_support_case@service.alipay.com