---
url: >-
  https://acquirer-api-docs-v4-en.pingpongx.com/en/notes/InPersonPayments/overview/index.md
description: >-
  PingPongCheckout's in-person payment solution supports building feature-rich
  point-of-sale integration systems, providing global multi-language support,
  diverse payment methods (such as credit cards and QR code payments), flexible
  network architecture, and unique shopping experiences. Easily manage payment
  terminals and transaction records through a unified management platform.
  Suitable for merchants who need localized payment experiences and customized
  terminal interfaces.
---
##  In-person payments

With PingPongCheckout's in-person payment solution, you can build feature-rich point-of-sale integration systems with the following characteristics:

• Global multi-language support - Provide multi-language support services worldwide

• Diverse payment methods - Support various global and local payment methods to meet different customer needs

• Flexible network architecture - Choose suitable network architecture solutions based on your business needs

• Unique shopping experience - Create unique shopping experiences for customers, seamlessly integrating offline and online payments

• Unified management platform - Easily manage your payment terminals and transaction records through a unified merchant backend

## Creating Unique Experiences for Customers

### Localized Payment Experience

Provide shoppers with local currency payment options and tax-free shopping benefits for overseas tourists, enhancing shopping convenience.
Personalized shopping experience

### Customized Terminal Interface

Develop fully customizable user interfaces for payment terminals, supporting:
- Brand customization - Incorporate your brand elements
- Language customization - Support multiple languages
- Feature extension - Support multiple payment methods

## How It Works

<v4-iImage :src="$withBase('/v4/InPersonPayments/flow-2.png')" name="System Interaction Flow"></v4-iImage>

## Supported Payment Methods

PingPongCheckout's in-person payment solution supports the following payment methods:

- Credit card payment     Cash register processes credit card payments directly through physical POS devices, supporting multiple card types.
- QR code payment       When your cash register has a rear screen that can display QR codes, payments can be completed by scanning codes.

### Credit Card Payment

1. **Interaction mode**:
    - One request for both order creation and payment
    - Customer swipes card directly on POS device
    - Payment result returns to cash register system

2. **Device dependency**:
    - Strongly dependent on physical POS devices
    - Must pass device identification parameters: `deviceSn`, `deviceModel`, `cashierDeviceId`
    - Payment requests are forwarded to specified POS device for execution

3. **Data characteristics**:
    - Returns detailed card transaction information (`cardTransinfo`)
    - Includes acquiring bank information, card number (usually masked), cardholder information, etc.
    - Supports queries to obtain more complete transaction details

4. **Refund characteristics**:
    - Refunds must be executed through the original POS device
    - Refund requests must include device information
    - Refund process is relatively synchronous, but still requires queries to confirm final status

### QR Code Payment

1. **Interaction mode**:
    - Asynchronous processing flow, divided into two phases: QR code acquisition and payment confirmation
    - System generates QR code, customer uses mobile device to scan and pay
    - Payment result requires waiting for user to complete payment operation

2. **Device dependency**:
    - Not dependent on POS hardware devices
    - Only requires cash register terminal to display QR code
    - Payment completed on user's mobile device

3. **Data characteristics**:
    - Returns QR code information: `qrCode`, `qrUrl`, `qrCodeExpired`
    - Does not include card transaction information
    - Data structure is relatively simple

   
## Status Flow

```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 : Create order and pay
    
    INIT --> PROCESSING : Initiate payment request
    INIT --> CLOSED : Timeout
    
    PROCESSING --> SUCCESS : Success receipt
    PROCESSING --> CANCEL : Order cancellation receipt
    PROCESSING --> FAILED : Failure receipt
    PROCESSING --> CLOSED : Timeout close/timeout receipt
    
    SUCCESS --> [*]
    CANCEL --> [*]
    FAILED --> [*]
    CLOSED --> [*]
    
    note right of INIT
        Initial state
        INIT
    end note
    
    note right of PROCESSING
        Processing
        PROCESSING
    end note
    
    note right of SUCCESS
        Success
        SUCCESS
    end note
    
    note right of CANCEL
        Cancel
        CANCEL
    end note
    
    note right of FAILED
        Failed
        FAILED
    end note
    
    note right of CLOSED
        Closed
        CLOSED
    end note
```