MasterCard Gateway安卓端3DS验证授权错误求助

授权错误可能遗漏的配置/步骤 #

• 确认测试卡有效性：必须使用MasterCard官方指定的测试专用卡（如BIN号512345开头的卡片），部分测试卡要求输入固定验证码（如1234），别用真实卡或无效测试卡。
• 核对请求参数一致性：生成3DS HTML时的amount、currency、orderId，必须和后续授权请求的参数完全匹配，哪怕是金额小数点位数、货币代码大小写错误都可能导致授权失败。
• 检查API密钥权限：你的API密钥是否同时拥有初始化支付、3DS验证、授权支付三类操作权限？部分商户创建的密钥仅开放了部分权限，需在商户后台调整。
• 确认商户测试环境配置：商户后台是否切换到测试模式？是否开启了3DS验证的测试支持？部分商户需要手动在后台启用测试环境的授权功能。
• 回调URL配置：商户后台的3DS验证回调URL是否正确？有没有加入白名单？若回调URL无效，验证完成后无法触发授权流程，直接报错。
• WebView加载配置：安卓端WebView是否开启了JavaScript执行？有没有正确设置WebViewClient处理跳转？3DS验证页面依赖JS完成参数传递和跳转，禁用JS会导致提交后无响应或错误。

安卓端完整实现步骤 #

1. 前期准备

   • 在MasterCard商户后台创建测试账户，获取merchantId和测试环境API密钥（注意区分生产/测试密钥）。
   • 在商户后台配置测试用回调URL（如your-app://3ds-callback），并将该URL加入白名单。
   • 准备HTTP请求工具（如OkHttp），或使用官方提供的安卓SDK。

2. 初始化支付会话

   • 调用/api/rest/version/72/merchant/{merchantId}/session接口，请求体示例：

     {
       "apiOperation": "INITIATE_CHECKOUT",
       "order": {
         "amount": "10.00",
         "currency": "USD",
         "id": "order_20240520_001"
       },
       "interaction": {
         "operation": "PURCHASE",
         "returnUrl": "your-app://payment-result"
       }
     }
     

   • 用API密钥对请求签名，获取返回的session.id（后续所有请求都依赖该会话ID）。

3. 获取3DS验证页面

   • 调用/api/rest/version/72/merchant/{merchantId}/order/{orderId}/authentication接口，请求体示例：

     {
       "apiOperation": "INITIATE_AUTHENTICATION",
       "session": {
         "id": "步骤2获取的sessionId"
       },
       "sourceOfFunds": {
         "provided": {
           "card": {
             "number": "5123450000000008",
             "securityCode": "123",
             "expiry": {
               "month": "12",
               "year": "2028"
             }
           }
         }
       }
     }
     

   • 从响应中提取authentication.redirectHtml字段，这就是要加载的3DS验证HTML代码。

4. WebView加载验证页面

   • 安卓端代码示例：

     WebView threeDSWebView = findViewById(R.id.webview_3ds);
     threeDSWebView.getSettings().setJavaScriptEnabled(true);
     threeDSWebView.setWebViewClient(new WebViewClient() {
         @Override
         public boolean shouldOverrideUrlLoading(WebView view, WebResourceRequest request) {
             String targetUrl = request.getUrl().toString();
             // 拦截配置的回调URL
             if (targetUrl.startsWith("your-app://")) {
                 // 解析URL中的验证结果参数
                 parse3DSResult(targetUrl);
                 return true;
             }
             return super.shouldOverrideUrlLoading(view, request);
         }
     });
     // 加载3DS验证页面
     threeDSWebView.loadDataWithBaseURL(null, redirectHtml, "text/html", "UTF-8", null);
     

   • 用户完成验证（如输入验证码）后，点击提交会跳转到配置的returnUrl。

5. 发起最终授权请求

   • 确认3DS验证通过后，调用/api/rest/version/72/merchant/{merchantId}/order/{orderId}/payment接口，请求体示例：

     {
       "apiOperation": "PAY",
       "session": {
         "id": "步骤2的sessionId"
       }
     }
     

   • 检查响应status字段，若为AUTHORISED则授权成功。

6. 错误处理

   • 捕获API返回的错误码，比如INSUFFICIENT_PERMISSIONS代表密钥权限不足，INVALID_CARD_DETAILS代表测试卡信息错误，根据错误码针对性调整。
   • WebView加载失败时，检查JS是否开启、HTML代码是否完整，或测试网络是否能访问MasterCard测试服务器。

内容的提问来源于stack exchange，提问作者Sami Shorman