---
url: >-
  https://acquirer-api-docs-v4-en.pingpongx.com/notes/zh/InPersonPayments/overview/index.md
description: >-
  PingPongCheckout的线下支付解决方案支持构建功能丰富的销售点集成系统，提供全球多语言支持、多样化支付方式（如信用卡和扫码支付）、灵活的网络架构及独特的购物体验。通过统一管理平台轻松管理支付终端和交易记录。适用于需要本地化支付体验和定制化终端界面的商户。
---
##  In-person payments

通过PingPongCheckout的线下支付解决方案，您可以构建功能丰富的销售点集成系统，具备以下特点：

• 全球多语言支持 - 在世界各地提供多种语言的支持服务

• 支付方式多样化 - 支持全球和本地各种支付方式，满足不同客户需求

• 灵活的网络架构 - 可根据您的业务需求选择合适的网络架构方案

• 独特的购物体验 - 为客户打造独特的购物体验，无缝整合线下和线上支付

• 统一管理平台 - 通过统一的商户后台，轻松管理您的支付终端和交易记录

## 为客户打造独特体验

### 本地化支付体验

为购物者提供本地货币支付选项，并为海外游客提供免税购物优惠，提升购物便利性。
个性化购物体验

### 定制化终端界面

为支付终端开发完全可定制的用户界面，支持：
- 品牌定制化 - 融入您的品牌元素
- 语言定制化 - 支持多种语言
- 功能扩展 - 支持多种支付方式

## 如何工作

```mermaid
%%{init: {
  'theme': 'base',
  'themeVariables': {
    'primaryColor': '#E3F2FD',
    'primaryTextColor': '#0D47A1',
    'primaryBorderColor': '#1976D2',
    'lineColor': '#1565C0',
    'secondaryColor': '#BBDEFB',
    'tertiaryColor': '#90CAF9',
    'background': '#F8FBFF',
    'mainBkg': '#E3F2FD',
    'secondBkg': '#BBDEFB',
    'tertiaryBkg': '#90CAF9',
    'actorBkg': '#2196F3',
    'actorBorder': '#1976D2',
    'actorTextColor': '#FFFFFF',
    'actorLineColor': '#1565C0',
    'signalColor': '#0D47A1',
    'signalTextColor': '#0D47A1',
    'noteBkgColor': '#E1F5FE',
    'noteTextColor': '#01579B',
    'noteBorderColor': '#0288D1',
    'loopTextColor': '#0D47A1',
    'activationBkgColor': '#B3E5FC',
    'activationBorderColor': '#0277BD'
  }
}}%%

sequenceDiagram
    participant Cashier
    participant PingPong
    participant Terminal

    Cashier->>PingPong: 1 Payment request
    PingPong->>Terminal: 2 Payment request
    Terminal->>Terminal: 3 Validate payment
    Terminal-->>PingPong: 4 Payment result

    alt Query payment result
        Cashier->>PingPong: 5 Payment query
        PingPong-->>Cashier: 6 Payment result
    end
```

## 支持的支付方式

PingPongCheckout的线下支付解决方案支持以下支付方式：

- 信用卡支付     收银机通过物理POS设备直接处理信用卡支付，支持多种卡类型。
- 扫码支付       当您的收银机有背面屏幕可以显示二维码时，可以扫码完成支付。

### 信用卡支付

1. **交互模式**：
    - 一次请求即是下单并支付。
    - 客户在POS设备上直接刷卡
    - 支付结果返回给收银系统

2. **设备依赖**：
    - 强依赖物理POS设备
    - 必须传递设备标识参数：`deviceSn`、`deviceModel`、`cashierDeviceId`
    - 支付请求会转发到指定的POS设备上执行

3. **数据特性**：
    - 返回详细的卡交易信息(`cardTransinfo`)
    - 包含收单行信息、卡号（通常脱敏）、持卡人信息等
    - 支持查询获取更完整的交易详情

4. **退款特点**：
    - 退款必须通过原POS设备执行
    - 退款请求必须包含设备信息
    - 退款过程相对同步，但仍需查询确认最终状态

### 二维码支付

1. **交互模式**：
    - 异步处理流程，分为获取二维码和支付确认两个阶段
    - 系统生成二维码，客户使用移动设备扫码支付
    - 支付结果需等待用户完成支付操作

2. **设备依赖**：
    - 不依赖POS硬件设备
    - 仅需收银终端展示二维码
    - 支付在用户移动设备上完成

3. **数据特性**：
    - 返回二维码信息：`qrCode`、`qrUrl`、`qrCodeExpired`
    - 不包含卡交易信息
    - 数据结构相对简单

   
## 状态流转

<ClientOnly>

```mermaid
%%{init: {
  'theme': 'base',
  'themeVariables': {
    'primaryColor': '#E8F4FD',
    'primaryTextColor': '#0D47A1',
    'primaryBorderColor': '#1976D2',
    'lineColor': '#1565C0',
    'secondaryColor': '#BBDEFB',
    'tertiaryColor': '#90CAF9',
    'background': '#F8FBFF',
    'mainBkg': '#E8F4FD',
    'secondBkg': '#BBDEFB',
    'tertiaryBkg': '#90CAF9'
  }
}}%%

stateDiagram-v2
    [*] --> INIT : 下单支付

    INIT --> PROCESSING : 发起支付请求
    INIT --> CLOSED : 超时

    PROCESSING --> SUCCESS : 成功回执
    PROCESSING --> CANCEL : 订单取消回执
    PROCESSING --> FAILED : 失败回执
    PROCESSING --> CLOSED : 超时关闭/超时回执

    SUCCESS --> [*]
    CANCEL --> [*]
    FAILED --> [*]
    CLOSED --> [*]

    note right of INIT
        初始态
        INIT
    end note

    note right of PROCESSING
        处理中
        PROCESSING
    end note

    note right of SUCCESS
        成功
        SUCCESS
    end note

    note right of CANCEL
        取消
        CANCEL
    end note

    note right of FAILED
        失败
        FAILED
    end note

    note right of CLOSED
        关闭
        CLOSED
    end note
```

</ClientOnly>