Antom, leading provider of tailored payment solutions

集成 PayPay Smart Payment 支付

Smart Payment 是 PayPay 推出的一款免密支付 JS SDK, 致力于优化买家的支付体验和提供支付成功率。它允许您将 PayPay 的功能集成到您的用户界面中,在获取买家授权后,买家在后续支付无需跳转 PayPay 应用即可完成支付。

用户体验

以下为首次支付和后续支付的用户体验:
首次支付
首次支付时,买家需登录 PayPay 进行授权,授权成功后买家将被重定向至商户页面继续完成支付。
Web
App
后续支付
后续支付时,不会拉起 PayPay 钱包应用,直接在商户侧完成支付。
Web
App

体验差异

首次支付和后续支付的用户体验在 Web/WAP 端集成上没有差别,在移动端的差别如下:
​
下单
跳转 normalUrl
PayPay 页面
回跳商户页面
异步通知
首次支付
无差别,均为调用 pay(单笔支付) 接口获取 normalUrl。
无差别,均通过 WebView 打开,并在 normalUrl 后拼上 source=embedded。
拉起 PayPay 应用的授权页面。
需在 paymentRedirectUrl 中获取 paypayRedirectUrl 和 one_time_token 参数,并需再次跳转该 URL。
无差别,仅支付成功和支付失败通知,无授权结果通知。
后续支付
在 H5 页面中展示 PayPay 支付页面。
paymentRedirectUrl 无额外参数,也无需再次跳转。

支付流程

以下分别为首次支付和后续支付流程示意图:
首次支付
后续支付

集成准备

在您开始集成前,请阅读集成指南及接口概述文档,了解服务端接口的集成步骤及调用接口的注意事项,并确保已完成以下预配置:
  • 已获得 client ID。
  • 已完成密钥配置。
  • 已完成异步通知接收地址的配置。
  • 集成服务端 SDK 资源包,并完成接口库安装及请求示例初始化。具体操作请参阅服务端 SDK。
为保障支付流程的兼容性与安全性,以下列出了各浏览器及应用的最低版本要求,其中商户 WebView 和 PayPay 应用需运行在指定的系统版本及以上环境:
  • 浏览器版本要求:
image.png
Edge
最近两个版本
image.png
Firefox
最近两个版本
image.png
Chrome
87 及以上
image.png
Safari
15 及以上
  • 商户 WebView 需支持 iOS 11 或以上、Android 4.4(API level 19)或以上。
  • PayPay 应用需运行于 iOS 16 或以上、Android 9 或以上。

支付集成

开始集成,请按照以下步骤操作:
  1. 创建支付订单
  2. 获取跳转支付推进链接
  3. 接收异步通知

步骤 1:创建支付订单
服务端

调用 pay(单笔支付)接口,在请求中指定 paymentMethod.paymentMethodType 为 PAYPAY,同时设置 paymentMethod.paymentMethodMetadata.smartPaymentEnabled 为 true。
注意:
  • 首次支付和后续支付均需调用 pay(单笔支付)接口,并跳转返回的支付推进链接 (normalUrl)。
  • 商户侧传入的 paymentRedirectUrl 必须是 https:// 开头。
以下代码展示了请求报文的示例:
JSONjson
{
  "order": {
    "env": {
      "osType": "IOS",
      "terminalType": "APP"
    },
    "orderAmount": {
      "currency": "JPY",
      "value": "1825"
    },
    "orderDescription": "TEST.COM",
    "referenceOrderId": "TEST4754300929"
  },
  "paymentAmount": {
    "currency": "JPY",
    "value": "1825"
  },
  "paymentMethod": {
    "paymentMethodMetadata": "{"smartPaymentEnabled":true}",
    "paymentMethodType": "PAYPAY"
  },
  "paymentNotifyUrl": "https://www.yourwebsite.com/notify/channel/notify",
  "paymentRedirectUrl": "https://www.yourwebsite.com/redirect",
  "paymentRequestId": "TEST4754300929",
  "productCode": "CASHIER_PAYMENT",
  "settlementStrategy": {
    "settlementCurrency": "JPY"
  }
}
Antom 收到请求后会返回对应的 PayPay 支付推进链接(normalUrl),示例代码如下:
JSONjson
{
  "normalUrl": "https://ac.alipay.com/page/antom-web-checkout-v2/payment-transition/pages/paypay/index.html?orderInfo=***test",
  "paymentActionForm": "{"method":"GET","paymentActionFormType":"RedirectActionForm","redirectUrl":"https://ac.alipay.com/page/antom-web-checkout-v2/payment-transition/pages/paypay/index.html?orderInfo=***test"}",
"paymentAmount": {
  "currency": "JPY",
  "value": "1825"
},
"paymentCreateTime": "2025-09-16T20:48:47-07:00",
"paymentId": "20250917******450216341557",
"paymentRequestId": "PAYMENT_202*****46357_AUTO",
"redirectActionForm": {
  "method": "GET",
  "redirectUrl": "https://ac.alipay.com/page/antom-web-checkout-v2/payment-transition/pages/paypay/index.html?orderInfo=***test"
},
"result": {
  "resultCode": "PAYMENT_IN_PROCESS",
  "resultMessage": "payment in process",
  "resultStatus": "U"
}
}

步骤 2:获取跳转支付推进链接
客户端

商户服务端拿到 Antom 返回的支付推进链 (normalUrl) 之后,将该地址传递给前端,由商户前端跳转至 PayPay 页面。以下为商户前端加载支付推进链接的示例代码:
Web/WAP
Web 端和 WAP 端可直接跳转 normalUrl,示例代码如下:
JavaScriptjavascript
window.location.href = pay.response.normalUrl;
注意:首次支付和后续支付均跳转 normalUrl 即可,Antom 会根据买家是否在浏览器中存储了支付信息来决策展示支付授权页(首次支付时)或半屏支付确认页(后续支付时)。
iOS
按照以下步骤处理 Antom 返回的支付推进链接 (normalUrl):

1. 拼接参数

iOS 端不能直接跳转 normalUrl,需要在 normalUrl 后拼接 source=embedded 参数,然后用 WebView 进行加载,示例如下:
text
https://ac.alipay.com/page/antom-web-checkout-v2/payment-transition/pages/paypay/index.html?orderInfo=Y2xpZW50SWQ9YV90M0I0ZERrRG1HJm1lcmNoYW50SWQ9MTg4QzBFR2tQWlhhRDN4dHFMZXVuRFM4UXdpbXU4YWR2V09Pc2VycFpWcWE3bz0mcGF5bWVudFJlcXVlc3RJZD1oNWtnZDdyQ0U0Nm91ZDJjdHhVcE5MSzZjOUpwRkR6M2VLVEsyTDQ0bFBjPSZtZXJjaGFudEFsaWFzPTkxODQ2MDc2MDQyMDU1NjgwMCZjaGFubmVsUGF5bWVudElkPTc0ODE3MjczNjM0NTYzJmFtb3VudD0zMDAmY3VycmVuY3k9SlBZJm1lcmNoYW50UmVkaXJlY3RVcmw9aHR0cHMlM0ElMkYlMkZwc3AuYWMuYWxpcGF5LmNvbSUyRnBhZ2UlMkZzaW11bGF0aW9uLXdhbGxldCUyRmFjd2FsbGV0JTJGYWxpcGF5Y29ubmVjdGNvZGUuaHRtbCZwYXltZW50UmVkaXJlY3RVcmw9aHR0cHMlM0ElMkYlMkZvcGVuLW5hLmFsaXBheS5jb20lMkZhcGklMkZvcGVuJTJGdXJsX2NhbGxiYWNrX3Nob3J0X2dldCUyRnNicHMlMkZ1cmxDYWxsYmFjay5odG0lM0ZzaWduRGF0YSUzREZFZDBhRGN6VHp6WTVzSlo3NVNtV3ZSUTRRcyUyNTNEJTI2aW5TZXJpYWxObyUzRDIwMjUwOTE3ODkwMzEzMDAwMDg1NTYxMTU1NDM2NTYlMjZvdXRPcmRlck5vJTNENzQ4MTcyNzM2MzQ1NjM=&region=SG&source=embedded

2. WebView 拦截与外跳

WebView 先加载 normalUrl 即 Antom 中间页,同时拦截重定向的 PayPay linkUrl 后外跳应用拉起 PayPay 应用或页面。
注意:如您需要使用 PayPay 的沙箱钱包,请联系 Antom 技术支持做额外报备。
objectivec
- (void)webView:(WKWebView *)webView decidePolicyForNavigationAction:(WKNavigationAction *)navigationAction decisionHandler:(void (^)(WKNavigationActionPolicy))decisionHandler {
  NSURL *url = navigationAction.request.URL;
  NSString *urlString = url.absoluteString;

  if ([urlString containsString:@"antom_sanbox"]) {
    NSURLComponents *components = [NSURLComponents componentsWithURL:url resolvingAgainstBaseURL:NO];
  NSMutableDictionary *queryParameters = [NSMutableDictionary dictionary];
  // 检查 URL 是否有查询项
  if (components.queryItems) {
    // 遍历所有的查询项
    for (NSURLQueryItem *item in components.queryItems) {
      if (item.value) {
        // 将参数名(name)和参数值(value)添加到字典中
        queryParameters[item.name] = item.value;
      }
    }
  }
  NSString *isDeeplinkUrl = queryParameters[@"isDeeplinkUrl"];
  if (isDeeplinkUrl && [isDeeplinkUrl length] > 0 && isDeeplinkUrl == @"true") {
    [[UIApplication sharedApplication] openURL:url options:@{} completionHandler:nil];
    decisionHandler(WKNavigationActionPolicyCancel);
    return;
  }
}

if ([urlString containsString:@"www.sandbox.paypay"] || [urlString containsString:@"www.paypay.ne.jp"]) {
  NSLog(@"Intermediate page/中间页");
NSLog(@"Merchant handles the subsequent logic/商户自己处理后续逻辑");

if (url) {
  // 使用 UIApplication.shared.open 打开 URL
  [[UIApplication sharedApplication] openURL:url options:@{} completionHandler:nil];
}

decisionHandler(WKNavigationActionPolicyCancel);
return;
}

decisionHandler(WKNavigationActionPolicyAllow);
}

3. 获取 paypayRedirectUrl 和 one_time_token 后进行二次跳转

PayPay 回跳商户页面后获取 paypayRedirectUrl 和 one_time_token。买家授权完成后会回跳商户的 paymentRedirectUrl,PayPay 在此链接(URL)后拼接 paypayRedirectUrl 和 one_time_token 两个参数,示例如下:
text
https://www.yourwebsite.com/ltspc/pay/callback/deeplink?paypayRedirectUrl=https%253A%252F%252Fac.alipay.com%252Fpage%252Fantom-web-checkout-v2%252Fpayment-transition%252Fpages%252Fpaypay%252Findex.html%253ForderInfo%253DY2xpZW50SWQ9YV90M0I0ZERrRG1HJm1lcmNoYW50SWQ9MTg4QzBFR2tQWlhhRDN4dHFMZXVuRFM4UXdpbXU4YWR2V09Pc2VycFpWcWE3bz0mcGF5bWVudFJlcXVlc3RJZD1wemFtMXk1NWlCWXdnVDhNQUpFK0tYVjlyMDQ5L0ZFQjBSY01DUWpXMlhvPSZtZXJjaGFudEFsaWFzPTkxODQ2MDc2MDQyMDU1NjgwMCZjaGFubmVsUGF5bWVudElkPTUwMzg1MzA0MzM2OTMxJmFtb3VudD0xMCZjdXJyZW5jeT1KUFkmbWVyY2hhbnRSZWRpcmVjdFVybD1odHRwcyUzQSUyRiUyRnByZS5hYy5hbGlwYXkuY29tJTJGcGFnZSUyRmFudG9tX3NhbmJveCUyRnJlZGlyZWN0Lmh0bWwlM0Z1cmwlM0RrYWRlbW8lM0ElMkYlMkZzZXR0aW5nJTJGcGF0aCUyNmF1dG8lM0QwJnBheW1lbnRSZWRpcmVjdFVybD1odHRwcyUzQSUyRiUyRm9wZW4tbmEuYWxpcGF5LmNvbSUyRmFwaSUyRm9wZW4lMkZ1cmxfY2FsbGJhY2tfc2hvcnRfZ2V0JTJGc2JwcyUyRnVybENhbGxiYWNrLmh0bSUzRnNpZ25EYXRhJTNEM0gxUVpFRUNFSzNMSkRkUnBCZm5XaWpSZnFvJTI1M0QlMjZpblNlcmlhbE5vJTNEMjAyNTEwMjM4OTAzMTMwMDAwOTc2OTYxNTM1MjkxNiUyNm91dE9yZGVyTm8lM0Q1MDM4NTMwNDMzNjkzMQ%25253D%25253D%2526region%253DSG%2526source%253Dembedded%2526isAuthorized%253Dtrue&one_time_token=2bdae7ec-9d3a-4636-9662-05fbdcf3e9f6&ppSmartPayment=1
paypayRedirectUrl 和 one_time_token 两个参数的提取以及 URL 解码的示例代码如下:
Objective-Cobjectivec
- (BOOL)application:(UIApplication *)application continueUserActivity:(NSUserActivity *)userActivity restorationHandler:(void (^)(NSArray<id<UIUserActivityRestoring>> * _Nullable))restorationHandler {
    if ([userActivity.activityType isEqualToString:NSUserActivityTypeBrowsingWeb]) {
        NSURL *url = userActivity.webpageURL;
        NSURLComponents *components = [NSURLComponents componentsWithURL:url resolvingAgainstBaseURL:NO];
        
        // 替换为paymentRedirectUrl中的host
        if ([components.host isEqualToString:@"psp.ac.alipay.com"]) {
            NSMutableDictionary *queryParameters = [NSMutableDictionary dictionary];
           // 检查 URL 是否有查询项
           if (components.queryItems) {
               // 遍历所有的查询项
               for (NSURLQueryItem *item in components.queryItems) {
                   if (item.value) {
                       // 将参数名(name)和参数值(value)添加到字典中
                       queryParameters[item.name] = item.value;
                   }
               }
           }
           NSString *paypayRedirectUrl = queryParameters[@"paypayRedirectUrl"];
           if (paypayRedirectUrl && [paypayRedirectUrl length] > 0) {
               paypayRedirectUrl = [paypayRedirectUrl stringByRemovingPercentEncoding];
               // 拼接 PayPay 参数
               NSString *refreshUrl = [NSString stringWithFormat:@"%@&one_time_token=%@&ppSmartPayment=1", queryParameters[@"paypayRedirectUrl"], queryParameters[@"one_time_token"]];

              // 重新刷新或打开支付页,此支付页面不会拉起 PayPay 应用,您需自行使用 WebView 加载拼接好的 paypayRedirectUrl
           }
        }
        return true;
}
当商户中间页拉起商户应用时,请勿丢失 paypayRedirectUrl 和 one_time_token 两个参数。在获取需二次跳转的链接后,您可通过 WebView 重新加载该链接(如代码第 25 行注释所注)。以下示例展示了需要二次跳转的链接,且该链接已经在 paypayRedirectUrl 后方拼接了 one_time_token:
注意:首次支付且买家授权成功,PayPay 需拼接 paypayRedirectUrl 和 one_time_token 两个参数,后续支付则不会有这两个参数,因此 PayPay 不需要在链接中拼接这两个参数。
需二次跳转的链接text
https://ac.alipay.com/page/antom-web-checkout-v2/payment-transition/pages/paypay/index.html?orderInfo=Y2xpZW50SWQ9YV90M0I0ZERrRG1HJm1lcmNoYW50SWQ9MTg4QzBFR2tQWlhhRDN4dHFMZXVuRFM4UXdpbXU4YWR2V09Pc2VycFpWcWE3bz0mcGF5bWVudFJlcXVlc3RJZD1wemFtMXk1NWlCWXdnVDhNQUpFK0tlMlY1MVh6eSt2TWxMd2V3NlYrN0s0PSZtZXJjaGFudEFsaWFzPTkxODQ2MDc2MDQyMDU1NjgwMCZjaGFubmVsUGF5bWVudElkPTUwMzg1NTQwMTY1MjUwJmFtb3VudD0xMCZjdXJyZW5jeT1KUFkmbWVyY2hhbnRSZWRpcmVjdFVybD1odHRwcyUzQSUyRiUyRnByZS5hYy5hbGlwYXkuY29tJTJGcGFnZSUyRmFudG9tX3NhbmJveCUyRnJlZGlyZWN0Lmh0bWwlM0Z1cmwlM0RrYWRlbW8lM0ElMkYlMkZzZXR0aW5nJTJGcGF0aCUyNmF1dG8lM0QwJnBheW1lbnRSZWRpcmVjdFVybD1odHRwcyUzQSUyRiUyRm9wZW4tbmEuYWxpcGF5LmNvbSUyRmFwaSUyRm9wZW4lMkZ1cmxfY2FsbGJhY2tfc2hvcnRfZ2V0JTJGc2JwcyUyRnVybENhbGxiYWNrLmh0bSUzRnNpZ25EYXRhJTNEQUhrTVdMOHpUd1clMjUyQmtXcGNFaG14UHJrSHk0SSUyNTNEJTI2aW5TZXJpYWxObyUzRDIwMjUxMDIzODkwMzEzMDAwMDkxNDEzMjAyNDY0OTYlMjZvdXRPcmRlck5vJTNENTAzODU1NDAxNjUyNTA%3D&region=SG&source=embedded&isAuthorized=true&one_time_token=4f4c7877-553b-438c-9739-d64109a2bd66&ppSmartPayment=1

4. 支付后处理

支付完成后会再次跳转到商户首次设置的 paymentRedirectUrl,此时 H5 将根据服务端结果展示支付结果,不会在 paymentRedirectUrl 上额外拼接参数。
Android
按照以下步骤处理 Antom 返回的支付推进链接 (normalUrl):

1. 拼接参数

Android 端不能直接跳转 normalUrl,需要在 normalUrl 后拼接 source=embedded 参数,然后用 WebView 进行加载,示例如下:
text
https://ac.alipay.com/page/antom-web-checkout-v2/payment-transition/pages/paypay/index.html?orderInfo=Y2xpZW50SWQ9YV90M0I0ZERrRG1HJm1lcmNoYW50SWQ9MTg4QzBFR2tQWlhhRDN4dHFMZXVuRFM4UXdpbXU4YWR2V09Pc2VycFpWcWE3bz0mcGF5bWVudFJlcXVlc3RJZD1oNWtnZDdyQ0U0Nm91ZDJjdHhVcE5MSzZjOUpwRkR6M2VLVEsyTDQ0bFBjPSZtZXJjaGFudEFsaWFzPTkxODQ2MDc2MDQyMDU1NjgwMCZjaGFubmVsUGF5bWVudElkPTc0ODE3MjczNjM0NTYzJmFtb3VudD0zMDAmY3VycmVuY3k9SlBZJm1lcmNoYW50UmVkaXJlY3RVcmw9aHR0cHMlM0ElMkYlMkZwc3AuYWMuYWxpcGF5LmNvbSUyRnBhZ2UlMkZzaW11bGF0aW9uLXdhbGxldCUyRmFjd2FsbGV0JTJGYWxpcGF5Y29ubmVjdGNvZGUuaHRtbCZwYXltZW50UmVkaXJlY3RVcmw9aHR0cHMlM0ElMkYlMkZvcGVuLW5hLmFsaXBheS5jb20lMkZhcGklMkZvcGVuJTJGdXJsX2NhbGxiYWNrX3Nob3J0X2dldCUyRnNicHMlMkZ1cmxDYWxsYmFjay5odG0lM0ZzaWduRGF0YSUzREZFZDBhRGN6VHp6WTVzSlo3NVNtV3ZSUTRRcyUyNTNEJTI2aW5TZXJpYWxObyUzRDIwMjUwOTE3ODkwMzEzMDAwMDg1NTYxMTU1NDM2NTYlMjZvdXRPcmRlck5vJTNENzQ4MTcyNzM2MzQ1NjM=&region=SG&source=embedded

2. WebView 拦截与外跳

WebView 先加载 normalUrl 即 Antom 中间页,同时拦截重定向的 PayPay linkUrl 后外跳应用拉起 PayPay 应用或页面。
注意:如您需要使用 PayPay 的沙箱钱包,请联系 Antom 技术支持做额外报备。
java
public class WebViewActivity extends AppCompatActivity {

    private WebView webView;

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_demo_web_view);
        webView = findViewById(R.id.webView);
        webView.setWebViewClient(new MyWebViewClient());
    }

    private class MyWebViewClient extends WebViewClient {
        @Override
        public boolean shouldOverrideUrlLoading(WebView view, WebResourceRequest request) {
             String url = "";
                if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.LOLLIPOP) {
                    url = request.getUrl().toString();
                } else {
                    url = request.toString();
                }

                Uri parsedUri = Uri.parse(url);

             if (parsedUri.toString().contains("antom_sanbox")) {
                Bundle queryParameters = new Bundle();
                for (String key : parsedUri.getQueryParameterNames()) {
                    queryParameters.putString(key, parsedUri.getQueryParameter(key));
                }
                boolean isDeeplinkUrl = Objects.equals(queryParameters.getString("isDeeplinkUrl"), "true");

                if (isDeeplinkUrl) {
                    // 在外部浏览器中打开链接
                    Intent intent = new Intent(Intent.ACTION_VIEW, Uri.parse(url));
                    startActivity(intent);
                    return true;
                }
            }

            if (url.contains("www.sandbox.paypay") || url.contains("www.paypay.ne.jp") {
                Log.d(TAG, "Intermediate page/中间页");
                Log.d(TAG, "Merchant handles the subsequent logic/商户自己处理后续逻辑");
                try {
                      Intent intent = new Intent(Intent.ACTION_VIEW, parsedUri);
                       startActivity(intent);
                        } catch (Exception e) {
//                            e.printStackTrace();
                        }
                        return true;
            }
            return false;
        }
    }

}

3. 获取 paypayRedirectUrl 和 one_time_token 后进行二次跳转

PayPay 回跳商户页面后获取 paypayRedirectUrl 和 one_time_token。买家授权完成后会回跳商户的 paymentRedirectUrl,PayPay 在此链接(URL)后拼接 paypayRedirectUrl 和 one_time_token 两个参数,示例如下:
text
https://www.yourwebsite.com/ltspc/pay/callback/deeplink?paypayRedirectUrl=https%253A%252F%252Fac.alipay.com%252Fpage%252Fantom-web-checkout-v2%252Fpayment-transition%252Fpages%252Fpaypay%252Findex.html%253ForderInfo%253DY2xpZW50SWQ9YV90M0I0ZERrRG1HJm1lcmNoYW50SWQ9MTg4QzBFR2tQWlhhRDN4dHFMZXVuRFM4UXdpbXU4YWR2V09Pc2VycFpWcWE3bz0mcGF5bWVudFJlcXVlc3RJZD1wemFtMXk1NWlCWXdnVDhNQUpFK0tYVjlyMDQ5L0ZFQjBSY01DUWpXMlhvPSZtZXJjaGFudEFsaWFzPTkxODQ2MDc2MDQyMDU1NjgwMCZjaGFubmVsUGF5bWVudElkPTUwMzg1MzA0MzM2OTMxJmFtb3VudD0xMCZjdXJyZW5jeT1KUFkmbWVyY2hhbnRSZWRpcmVjdFVybD1odHRwcyUzQSUyRiUyRnByZS5hYy5hbGlwYXkuY29tJTJGcGFnZSUyRmFudG9tX3NhbmJveCUyRnJlZGlyZWN0Lmh0bWwlM0Z1cmwlM0RrYWRlbW8lM0ElMkYlMkZzZXR0aW5nJTJGcGF0aCUyNmF1dG8lM0QwJnBheW1lbnRSZWRpcmVjdFVybD1odHRwcyUzQSUyRiUyRm9wZW4tbmEuYWxpcGF5LmNvbSUyRmFwaSUyRm9wZW4lMkZ1cmxfY2FsbGJhY2tfc2hvcnRfZ2V0JTJGc2JwcyUyRnVybENhbGxiYWNrLmh0bSUzRnNpZ25EYXRhJTNEM0gxUVpFRUNFSzNMSkRkUnBCZm5XaWpSZnFvJTI1M0QlMjZpblNlcmlhbE5vJTNEMjAyNTEwMjM4OTAzMTMwMDAwOTc2OTYxNTM1MjkxNiUyNm91dE9yZGVyTm8lM0Q1MDM4NTMwNDMzNjkzMQ%25253D%25253D%2526region%253DSG%2526source%253Dembedded%2526isAuthorized%253Dtrue&one_time_token=2bdae7ec-9d3a-4636-9662-05fbdcf3e9f6&ppSmartPayment=1
paypayRedirectUrl 和 one_time_token 两个参数的提取以及 URL 解码的示例代码如下:
java
/**
 * 当Activity接收到新的Intent时调用
 * @param intent 新的Intent
 */
@Override
protected void onNewIntent(Intent intent) {
  super.onNewIntent(intent);
  if (Intent.ACTION_VIEW.equals(intent.getAction())) {
    Uri uri = intent.getData();
    if (uri == null) {
      return;
    }
    if (uri.getHost() == null) {
      return;
    }
    // 替换为paymentRedirectUrl中的host
    if (uri.getHost().equals("psp.ac.alipay.com")) {
      Bundle queryParameters = new Bundle();

      // 遍历所有的查询项
      for (String key : uri.getQueryParameterNames()) {
        // 将参数名(name)和参数值(value)添加到字典中
        queryParameters.putString(key, uri.getQueryParameter(key));
      }
      String paypayRedirectUrl = queryParameters.getString("paypayRedirectUrl");

      if (
        queryParameters.getString("paypayRedirectUrl") != null &&
        !Objects.requireNonNull(paypayRedirectUrl).isEmpty()
      ) {
        try {
          // 拼接 PayPay 参数
          String paypayRedirectUrl = queryParameters.getString("paypayRedirectUrl");
          String decodedUriString = URLDecoder.decode(paypayRedirectUrl, "UTF-8");
          String refreshUrl =
            decodedUriString +
            "&one_time_token=" +
            queryParameters.getString("one_time_token") +
            "&ppSmartPayment=1";
          // 重新刷新或打开支付页,此支付页面不会拉起 PayPay 应用,您需自行使用 WebView 加载拼接好的 paypayRedirectUrl
        } catch (Exception e) {
          Log.d(TAG, "handleIntent: ", e);
        }
      }
    }
  }
}
当商户中间页拉起商户应用时,请勿丢失 paypayRedirectUrl 和 one_time_token 两个参数。在获取需二次跳转的链接后,您可通过 WebView 重新加载该链接(如代码第 35 行注释所注)。以下示例展示了需要二次跳转的链接,且该链接已经在 paypayRedirectUrl 后方拼接了 one_time_token:
注意:首次支付且买家授权成功,PayPay 需拼接 paypayRedirectUrl 和 one_time_token 两个参数,后续支付则不会有这两个参数,因此 PayPay 不需要在链接中拼接这两个参数。
text
https://ac.alipay.com/page/antom-web-checkout-v2/payment-transition/pages/paypay/index.html?orderInfo=Y2xpZW50SWQ9YV90M0I0ZERrRG1HJm1lcmNoYW50SWQ9MTg4QzBFR2tQWlhhRDN4dHFMZXVuRFM4UXdpbXU4YWR2V09Pc2VycFpWcWE3bz0mcGF5bWVudFJlcXVlc3RJZD1wemFtMXk1NWlCWXdnVDhNQUpFK0tlMlY1MVh6eSt2TWxMd2V3NlYrN0s0PSZtZXJjaGFudEFsaWFzPTkxODQ2MDc2MDQyMDU1NjgwMCZjaGFubmVsUGF5bWVudElkPTUwMzg1NTQwMTY1MjUwJmFtb3VudD0xMCZjdXJyZW5jeT1KUFkmbWVyY2hhbnRSZWRpcmVjdFVybD1odHRwcyUzQSUyRiUyRnByZS5hYy5hbGlwYXkuY29tJTJGcGFnZSUyRmFudG9tX3NhbmJveCUyRnJlZGlyZWN0Lmh0bWwlM0Z1cmwlM0RrYWRlbW8lM0ElMkYlMkZzZXR0aW5nJTJGcGF0aCUyNmF1dG8lM0QwJnBheW1lbnRSZWRpcmVjdFVybD1odHRwcyUzQSUyRiUyRm9wZW4tbmEuYWxpcGF5LmNvbSUyRmFwaSUyRm9wZW4lMkZ1cmxfY2FsbGJhY2tfc2hvcnRfZ2V0JTJGc2JwcyUyRnVybENhbGxiYWNrLmh0bSUzRnNpZ25EYXRhJTNEQUhrTVdMOHpUd1clMjUyQmtXcGNFaG14UHJrSHk0SSUyNTNEJTI2aW5TZXJpYWxObyUzRDIwMjUxMDIzODkwMzEzMDAwMDkxNDEzMjAyNDY0OTYlMjZvdXRPcmRlck5vJTNENTAzODU1NDAxNjUyNTA%3D&region=SG&source=embedded&isAuthorized=true&one_time_token=4f4c7877-553b-438c-9739-d64109a2bd66&ppSmartPayment=1

4. 支付后处理

支付完成后会再次跳转到商户首次设置的 paymentRedirectUrl,此时 H5 将根据服务端结果展示支付结果,不会在 paymentRedirectUrl 上额外拼接参数。
注意:
  • 支付流程需确保从 PayPay 成功跳回原浏览器页面,若无法回到原浏览器,支付将失败。
  • 在后续访问商店并进行购买时,若用户使用与首次支付相同的设备和浏览器,且浏览器 cookie 在 395 天内未被清除,则可在此期间免登录直接付款。若超过 395 天未再次购买商品,或更换了设备、浏览器,则需重新登录。
  • 无痕(隐私)模式 不支持后续免登录支付。
  • 在后续支付过程中,不得更换 PayPay 账号,否则流程无法继续。

步骤 3:接收异步通知
服务端

完成支付或支付失败时,Antom 会通过 pay(单笔支付)接口中的参数 paymentNotifyUrl 指定的地址发送异步通知(notifyPayment)。具体操作参阅支付结果异步通知。 异步通知详情请见以下表格:首次支付将返回授权及支付结果,后续支付仅返回支付结果。以下是常见场景:
常见场景
获取到的异步通知情况
首次授权成功且支付成功
授权成功无通知,授权后支付成功发送通知。
首次授权成功但支付失败
授权成功无通知,授权后支付失败发送通知。
首次授权失败
关单后发送支付失败通知。
后续支付
按照支付状态发送支付通知。
Antom 提供发送异步通知的功能,同时也支持通过调用 inquiryPayment 接口主动查询支付结果。
支付成功
支付成功异步通知示例代码如下:
json
{
  "actualPaymentAmount": {
    "currency": "JPY",
    "value": "10"
  },
  "notifyType": "PAYMENT_RESULT",
  "paymentAmount": {
    "currency": "JPY",
    "value": "10"
  },
  "paymentCreateTime": "2025-11-04T03:03:23-08:00",
  "paymentId": "20251104194010800100188370226536257",
  "paymentRequestId": "PAYMENT_20251104190322542_AUTO",
  "paymentResultInfo": {},
  "paymentTime": "2025-11-04T03:07:20-08:00",
  "result": {
    "resultCode": "SUCCESS",
    "resultMessage": "success.",
    "resultStatus": "S"
  }
}
支付失败
支付失败异步通知示例代码如下:
json
{
  "actualPaymentAmount": {
    "currency": "JPY",
    "value": "10"
  },
  "notifyType": "PAYMENT_RESULT",
  "paymentAmount": {
    "currency": "JPY",
    "value": "10"
  },
  "paymentCreateTime": "2025-10-21T19:30:26-07:00",
  "paymentId": "20251022194010800100188520223208649",
  "paymentRequestId": "PAYMENT_20251022103025254_AUTO",
  "result": {
    "resultCode": "ORDER_IS_CLOSED",
    "resultMessage": "The order is closed.",
    "resultStatus": "F"
  }
}

最佳实践

根据买家移动端是否安装 PayPay 钱包应用,系统会提供不同的后续操作:
  • 买家已安装 PayPay 钱包应用,可以选择外跳拉起 PayPay 钱包应用,详情参考上述方案。
  • 买家未安装 PayPay 钱包应用,可以采用 WebView 应用内重定向流程,详情参考下文最佳实践。
iOS
以下代码展示了 iOS 应用中如何利用 WebView 加载网页,并根据不同的支付场景智能处理跳转逻辑:
java
- (void)webView:(WKWebView *)webView decidePolicyForNavigationAction:(WKNavigationAction *)navigationAction decisionHandler:(void (^)(WKNavigationActionPolicy))decisionHandler {
    NSURL *url = navigationAction.request.URL;
    NSString *urlString = url.absoluteString;
    
    // 使用 Antom 沙箱环境钱包(与 PayPay 沙箱环境钱包 2 选 1)
    if ([urlString containsString:@"antom_sanbox"]) {
        NSURLComponents *components = [NSURLComponents componentsWithURL:url resolvingAgainstBaseURL:NO];
        NSMutableDictionary *queryParameters = [NSMutableDictionary dictionary];
        // 检查 URL 是否有查询项
        if (components.queryItems) {
            // 遍历所有的查询项
            for (NSURLQueryItem *item in components.queryItems) {
                if (item.value) {
                    // 将参数名(name)和参数值(value)添加到字典中
                    queryParameters[item.name] = item.value;
                }
            }
        }
        NSString *isDeeplinkUrl = queryParameters[@"isDeeplinkUrl"];
        if (isDeeplinkUrl && [isDeeplinkUrl length] > 0 && isDeeplinkUrl == @"true") {
            NSURL *sandboxUrl = [NSURL URLWithString:@"alipayconnect://"];
            if (sandboxUrl && [[UIApplication sharedApplication] canOpenURL:sandboxUrl]) {
                [[UIApplication sharedApplication] openURL:url options:@{} completionHandler:nil];
                decisionHandler(WKNavigationActionPolicyCancel);
                return;
            } else {
                decisionHandler(WKNavigationActionPolicyAllow);
                return;
            }
        }
    }

    // 使用 PayPay 沙箱环境钱包(与 Antom 沙箱环境钱包 2 选 1)
    if (([urlString containsString:@"www.sandbox.paypay"] || [urlString containsString:@"www.paypay.ne.jp"])) {
        
        if (url && [[UIApplication sharedApplication] canOpenURL:[NSURL URLWithString:@"paypay://"]]) {
            // 使用 UIApplication.shared.open 打开 URL
            [[UIApplication sharedApplication] openURL:url options:@{} completionHandler:nil];
            decisionHandler(WKNavigationActionPolicyCancel);
            return;
        } else {
            decisionHandler(WKNavigationActionPolicyAllow);
            return;
        }
    }
    
    // 替换为 paymentRedirectUrl 中的 host
    if ([urlString containsString:@"psp.ac.alipay.com"]) {
        NSURLComponents *components = [NSURLComponents componentsWithURL:url resolvingAgainstBaseURL:NO];
        NSMutableDictionary *queryParameters = [NSMutableDictionary dictionary];
        // 检查 URL 是否有查询项
        if (components.queryItems) {
            // 遍历所有的查询项
            for (NSURLQueryItem *item in components.queryItems) {
                if (item.value) {
                    // 将参数名(name)和参数值(value)添加到字典中
                    queryParameters[item.name] = item.value;
                }
            }
        }
        NSString *paypayRedirectUrl = queryParameters[@"paypayRedirectUrl"];
        if (paypayRedirectUrl && [paypayRedirectUrl length] > 0) {
            paypayRedirectUrl = [paypayRedirectUrl stringByRemovingPercentEncoding];
            // 拼接 PayPay 参数,重新刷新或打开支付页
            NSString *refreshUrl = [NSString stringWithFormat:@"%@&one_time_token=%@&ppSmartPayment=1", queryParameters[@"paypayRedirectUrl"], queryParameters[@"one_time_token"]];
            decisionHandler(WKNavigationActionPolicyCancel);
            // 重新刷新或打开支付页,此支付页面不会拉 PayPay 应用
            NSURLRequest *request = [NSURLRequest requestWithURL:[NSURL URLWithString:refreshUrl]];
            [self.webView loadRequest:request];
            return;
        }

        decisionHandler(WKNavigationActionPolicyAllow);
        return;
    }
    
    decisionHandler(WKNavigationActionPolicyAllow);
}
除了参考上述代码判断是否安装支付应用外,还需要在 Info.plist 配置文件中添加 LSApplicationQueriesSchemes 字段,用于声明可被查询的 URL Scheme。
注意:Info.plist 中可配置的 Scheme 数量是有限制的。
java
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
	<key>LSApplicationQueriesSchemes</key>
	<array>
		<string>paypay</string>
        <string>alipayconnect</string>
	</array>
</dict>
</plist>
Android
以下代码展示了 Android 应用中如何利用 WebView 加载网页,并根据不同的支付场景智能处理跳转逻辑:
java
public class WebViewActivity extends AppCompatActivity {

    private WebView webView;

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_demo_web_view);
        webView = findViewById(R.id.webView);
        webView.setWebViewClient(new MyWebViewClient());
    }

    private class MyWebViewClient extends WebViewClient {
        @Override
        public boolean shouldOverrideUrlLoading(WebView view, WebResourceRequest request) {
            String url = "";
            if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.LOLLIPOP) {
                url = request.getUrl().toString();
            } else {
                url = request.toString();
            }

            Uri parsedUri = Uri.parse(url);
            
            // 使用 Antom 沙箱环境钱包(与 PayPay 沙箱环境钱包 2 选 1)
            if (parsedUri.toString().contains("antom_sanbox")) {
                Bundle queryParameters = new Bundle();
                for (String key : parsedUri.getQueryParameterNames()) {
                    queryParameters.putString(key, parsedUri.getQueryParameter(key));
                }
                boolean isDeeplinkUrl = Objects.equals(queryParameters.getString("isDeeplinkUrl"), "true");

                if (isDeeplinkUrl) {
                    Intent schemeIntent = createSchemeIntent("alipayconnect://platformapi");
                    if (schemeIntent != null && isAppIsInstalled(schemeIntent)) {
                        // 在外部浏览器中打开链接
                        Intent intent = new Intent(Intent.ACTION_VIEW, Uri.parse(url));
                        startActivity(intent);
                    } else {
                        webView.loadUrl(url);
                    }
                    return true;
                }
            }
            
            // 使用 PayPay 沙箱环境钱包(与 Antom 沙箱环境钱包 2 选 1)
            if (url.contains("www.sandbox.paypay") || url.contains("www.paypay.ne.jp") {
                Intent schemeIntent = createSchemeIntent("paypay://");
                if (schemeIntent != null && isAppIsInstalled(schemeIntent)) {
                  try {
                      Intent intent = new Intent(Intent.ACTION_VIEW, parsedUri);
                       startActivity(intent);
                        } catch (Exception e) {
                           e.printStackTrace();
                        }
                    return true;
                } else {
                    webView.loadUrl(url);
                }
                return true;
            }

            if (parsedUri != null && parsedUri.getHost().equals("psp.ac.alipay.com")) {
                Bundle queryParameters = new Bundle();
                // 遍历所有的查询项
                for (String key : parsedUri.getQueryParameterNames()) {
                    // 将参数名(name)和参数值(value)添加到字典中
                    queryParameters.putString(key, parsedUri.getQueryParameter(key));
                }

                if (queryParameters.getString("paypayRedirectUrl") != null) {
                    try {
                        // 拼接 PayPay 参数
                        String paypayRedirectUrl = queryParameters.getString("paypayRedirectUrl");
                        String decodedUriString = URLDecoder.decode(paypayRedirectUrl, "UTF-8");
                        String refreshUrl = decodedUriString + "&one_time_token=" + queryParameters.getString("one_time_token") + "&ppSmartPayment=1";

                        // 重新刷新或打开支付页,此支付页面不会拉 PayPay 应用
                         webView.loadUrl(refreshUrl);
                    } catch (Exception e) {
                        Log.d(TAG, "handleIntent: ", e);
                    }
                }
            }

            return super.shouldOverrideUrlLoading(view, request);
        }
     }

    
        /**
     * 创建scheme intent
     * @param url scheme url
     * @return Intent对象
     */
    private Intent createSchemeIntent(String url) {
        Intent intent;
        try {
            intent = Intent.parseUri(url, Intent.URI_INTENT_SCHEME);
            intent.addCategory("android.intent.category.BROWSABLE");
            intent.setComponent(null);

            if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.ICE_CREAM_SANDWICH_MR1) {
                intent.setSelector(null);
            }
        } catch (URISyntaxException e) {
            showToast(LoadWebViewActivity.this,
                    "The third-party app is not installed!
您所打开的第三方App未安装!");
        }

        return intent;
    }
按以下代码判断第三方 App 是否已安装:
java
 /**
     * 判断第三方App是否已安装
     *
     * @param intent Intent对象
     * @return 是否已安装
     */
    private boolean isAppIsInstalled(Intent intent) {
        try {
            List<ResolveInfo> resolves = getPackageManager().queryIntentActivities(intent, 0);
            return !resolves.isEmpty();
        } catch (Exception e) {
            return false;
        }
    }

}
为了遵守 Android 系统的隐私与安全策略,需要在 AndroidManifest.xml 中添加 <queries> 标签,并在其中配置支付应用的包名,以确保支付跳转链接能够正常调用对应的支付方式应用。
java

<queries>
  <package android:name="jp.ne.paypay.android.app" />
  <package android:name="com.iap.linker_portal" />
</queries>
常见问题
问:授权成功但支付失败,后续支付如何处理?
答:授权后支付失败存在以下三种情况,请根据不同情况进行处理:
  • 授权成功但是支付失败,令牌在浏览器中仍然生效,因此后续支付时只展示 PayPay 的支付确认页,不跳转 PayPay 应用。
  • 首次授权时仅在 PayPay 侧完成认证回跳到商户侧,并没有再次跳转到 PayPay 的 paypayRedirectUrl,则表示授权失败,令牌不会在浏览器中生效,需要引导买家再次授权并支付。
  • 首次授权成功后,如果买家清除浏览器缓存、清除应用数据或重装应用,将导致令牌失效,需要引导买家再次授权并支付。