卡支付-收银台模式集成

该文档介绍收银台支付下，使用银行卡支付的集成要求。

1. 集成准备

查看收银台支付-集成准备。

2. 交互流程

相比收银台支付通用流程，在集成卡支付时的主要差异为：用户可能需要完成额外的3DS认证流程。

%%{init: {
  'theme': 'base',
  'themeVariables': {
    'primaryColor': '#e6f0ff',
    'primaryTextColor': '#333',
    'primaryBorderColor': '#5b9bd5',
    'lineColor': '#888',
    'actorMargin': 40,
    'noteBkgColor': '#0056b3',
    'noteTextColor': '#ffffff',
    'noteBorderColor': '#004a99'
  }
}}%%
sequenceDiagram
    participant User as 用户
    participant Client as 商户客户端
    participant MServer as 商户服务端
    participant Checkout as PayerMax收银页
    participant PMServer as PayerMax服务器
    participant Channel as 支付渠道

    %% 1. 下单流程
    User->>Client: 1.1 选择商品下单
    Client->>MServer: 1.2 选择商品下单
    MServer->>PMServer: 1.3 创建支付
调用收银台下单接口
    PMServer-->>MServer: 1.4 返回创建支付响应
含PayerMax收银页URL
    MServer-->>Client: 1.4 返回响应
    Client->>Checkout: 2.1 重定向，打开PayerMax收银页

    %% 2. 支付与3DS验证
    User->>Checkout: 3.1 选择支付方式
并提交支付
    Checkout->>PMServer: 3.2 支付请求
    PMServer->>Channel: 3.3 创建交易
并推进支付
    PMServer->>Channel: 3.4 3DS 验证请求
    Channel-->>PMServer: 3.5 返回3DS请求结果
    PMServer-->>Checkout: 3.6 请求结果
含3DS 认证页面URL

    Checkout->>Checkout: 3.7 重定向3DS认证页
    User->>Checkout: 3.8 输入信息，完成3DS认证
    Checkout->>Checkout: 3.9 重定向，跳转至PayerMax支付结果页
    User->>Checkout: 3.10 用户点击【返回商户】
    Checkout-->>Client: 3.11 重定向，跳转至商户指定页面

    %% 后台结果处理
    Channel-->>PMServer: 3.12 3DS认证结果
    PMServer->>Channel: 3.13 推进支付
    Channel-->>PMServer: 3.14 支付结果

    %% --- 获取支付结果色块 (与参考代码样式一致) ---
    rect rgb(235, 245, 255)
        Note over MServer, PMServer: 获取支付结果
        
        Note over MServer, PMServer: 通过支付结果通知
        PMServer->>MServer: 4.1 支付结果异步通知
        MServer-->>PMServer: 4.2 接收响应
        
        Note over MServer, PMServer: 通过支付订单查询
        MServer->>PMServer: 5.1 查询支付交易单
        PMServer-->>MServer: 5.2 交易详情，含支付结果
    end

3. 接口列表

查看收银台支付-接口列表。

4. 环境信息

• 测试环境：https:// pay-gate-uat.payermax.com/aggregate-pay/api/gateway/ <接口PATH>

• 集成环境：https:// pay-gate.payermax.com/aggregate-pay/api/gateway/ <接口PATH>

5. 集成步骤

5.1 创建支付

查看收银台支付-创建支付-使用CARD支付方式；支持使用推荐卡进行支付。

可以通过请求参数data.paymentDetail.allowedCardOrg指定卡组。不同国家下卡支付的卡组信息，请查看支付方式列表。

5.2 跳转PayerMax收银页

查看收银台支付-跳转PayerMax收银页。

5.3 完成3DS认证

收银台支付下，直接使用PayerMax 3DS服务，PayerMax依据内部风控结果，决策是否发起3DS认证流程，商户无须额外的集成工作。

5.4 跳转支付结果页

查看收银台支付-跳转支付结果页。

5.5 获取支付结果

查看收银台支付-获取支付结果。

6. 测试上线

在商户完成上述集成步骤后，可以发起实际支付请求进行初步测试验证，具体步骤请查看集成测试-发起测试。

在测试通过后，最终发布上线前，须联系PayerMax技术支持，提交测试的订单信息，以便于PayerMax检查请求日志和数据，确认您已经正确集成相关能力，具体步骤请查看集成测试-发起验收。

验收通过后，商户可以配置生产环境的集成信息，并准备开量事宜。

另外，在收单产品集成下有PayerMax支持的各类支付方式的集成文档，其中包含每种支付方式的测试上线说明。

7. 错误排除

测试或验收过程中的响应错误，可以查看错误排查-错误码。同时，在常见问题中，总结列举各类常见的问题及其处理方式。

您还可以直接联系PayerMax技术支持团队，咨询集成、测试、验收过程中的任何问题。