Alipay, China's leading third-party online payment solutionAlipay, China's leading third-party online payment solution

Domain name upgrade

中文版文档

Alipay is implementing a domain name upgrade for the cross-border payment solution. This upgrade involves changing the domain names for API calls and the SFTP server domain names.

As a merchant, it is important to update to the new domain names in preparation for the upgrade. This document provides the list of new domain names and detailed instructions for the transition.

Category

Original domain name

Switching requirements

New domain name

Endpoint examples

Acquiring & Payment

mapi.alipay.com

Mandatory

Europe:

api-eu-global.alipayplus.com

USA:

api-na-global.alipayplus.com

Other regions:

api-sea-global.alipayplus.com

Before:
https://xxxx.alipay.com/gateway.do
After:
https://api-xxx-global.alipayplus.com/gateway.do

globalmapi.alipay.com

Optional

intlmapi.alipay.com

Optional

mapi-hk.alipay.com

Optional

Alipay Open Platform

openapi.alipay.com

Mandatory

Europe:

openapi-eu-global.alipayplus.com

USA:

openapi-na-global.alipayplus.com

Other regions:

openapi-sea-global.alipayplus.com

Before:
https://xxxopenapi.alipay.com/gateway.do
After:
https://openapi-xxx-global.alipayplus.com/gateway.do

globalopenapi.alipay.com

Optional

openapihk.alipay.com

Optional

SFTP server

sftp.alipay.com

Mandatory

Europe:

isftp-eu.alipayplus.com

USA:

isftp-na.alipayplus.com

Other regions:

isftp-sea.alipayplus.com

Before:
sftp://xxx.alipay.com:22
After:
sftp://isftp-xxx.alipayplus.com:22

isftp.alipay.com

Optional

Notes:

  • Switching requirements:
    • Mandatory: It is mandatory to switch to the new domain name due to regulatory compliance and other factors. The original domain name will stop service later after the domain name upgrade.
    • Optional: The original domain name remains usable after the domain name upgrade. However, it is recommended to switch to the new domain name for a better network connection.
  • Select the new domain name that you use according to your entity's registered location.
  • Alipay Open Platform: Use these domain names to integrate with Alipay Open Platform APIs for cross-border services. If you have any questions, contact Alipay technical team.

Domain name upgrade

Refer to the following table for an overview of the domain name changes for each Alipay network service.

Alipay network

Before the upgrade

After the upgrade (in plan)

Acquiring & payment

image


image


Alipay Open Platform

image


image


SFTP server

image


image


Note: In the pictures above, the new domain names are indicated in red.

Schedule

The new domain names are already available and ready for use.

All original domain names that require mandatory switching will be discontinued as of August 31st, 2024 (in plan).

Key considerations

To facilitate a smooth switchover, you need to pay attention to the following information regarding the domain name switchover.

Transit window

Start time: effective immediately.

Deadline:August 31st, 2024.

Important: The original domain names that are mandatory to switch from are planned to stop service on August 31st, 2024, which is the deadline for the switchover.

Recommended preparations

Before switching to the new domain names, please take the following actions to ensure a seamless transition:

  • Perform connectivity, latency, and other tests on the new domain names to validate their functionality.
  • If needed, let your partner know the Alipay domain name will change. And if there is an allowlist control, add the new domain name promptly.
  • If needed, add the Alipay IP addresses to the allowlist as follows:

Direction

Scenario

Recommended configuration

Merchant → Alipay

API call

If allowlisting is required, it is recommended to keep the existing allowlisted IP addresses and add the new IP addresses. For more information, see Related IP addresses.

  • For SFTP server domain name switchover:
    • Use your SFTP account and password, which will remain the same after the switchover, to log in to the new domain names to validate the account and password. It is not recommended to configure the SFTP server IP address allowlist.
    • If you have any questions about the transition process, please contact our support team. For more information, see the Support section.

Related IP addresses

Post_upgrade, the following IP addresses can be obtained by resolving Alipay's new domain names:

  • 198.11.144.0/24
  • 198.11.148.0/24
  • 198.11.150.0/24
  • 198.11.186.0/24
  • 205.204.106.0/24
  • 205.204.107.0/24
  • 205.204.108.0/24
  • 205.204.122.0/24
  • 47.88.134.144/29
  • 47.89.73.128/26
  • 47.89.73.192/26
  • 47.89.81.128/25
  • 62.128.96.16/28
  • 62.128.96.96/27
  • 47.235.0.0/19

Support

If you need help with issues regarding the domain name switchover, contact us via email. Compose your message with the subject line "Domain Name Upgrade_[Your Merchant Name]" and send it to overseas_support@service.alibaba.com. Our support team will get back to you soon.