---
url: 'https://acquirer-api-docs-v4-en.pingpongx.com/en/notes/start/step/index.md'
description: >-
  Prerequisites documentation introduces the necessary steps before using
  PingPongCheckout, including obtaining sandbox accounts, determining
  integration solutions, API authorization configuration, and production
  environment verification. It covers the entire process from testing to
  official launch, suitable for developers who wish to integrate payment
  solutions.
---
Before starting development with PingPongCheckout products and solutions, please familiarize yourself with our latest documentation, including developer guides, API references, code examples, etc. The integration process is conducted through communication in the integration group.


```mermaid
%%{init: {
  'theme': 'base',
  'themeVariables': {
    'primaryColor': '#2196F3',
    'primaryTextColor': '#FFFFFF',
    'primaryBorderColor': '#1976D2',
    'lineColor': '#1565C0',
    'secondaryColor': '#E3F2FD',
    'tertiaryColor': '#BBDEFB',
    'background': '#F8FBFF',
    'mainBkg': '#E3F2FD',
    'nodeBorder': '#1976D2',
    'clusterBkg': '#F5F5F5',
    'clusterBorder': '#1976D2',
    'titleColor': '#0D47A1'
  }
}}%%

flowchart LR
    Start([🚀 Start]) --> Plan[📋 Determine<br/>Integration Solution]
    Plan --> Sandbox[🧪 Sandbox<br/>Integration]
    Sandbox --> Test[✅ Sandbox<br/>Testing & Acceptance]
    Test --> Decision{📊 Acceptance<br/>Result}

    Decision -->|❌ Failed| Sandbox
    Decision -->|✅ Passed| Auth[🔐 API<br/>Authorization]

    Auth --> Params[📦 Get Production<br/>Parameters]
    Params --> ProdTest[🔧 Production<br/>Testing]
    ProdTest --> Live[🎉 Production<br/>Available]
    Live --> End([🏁 End])

    style Start fill:#2196F3,stroke:#1976D2,color:#FFFFFF
    style End fill:#2196F3,stroke:#1976D2,color:#FFFFFF
    style Plan fill:#E3F2FD,stroke:#1976D2,color:#0D47A1
    style Sandbox fill:#E3F2FD,stroke:#1976D2,color:#0D47A1
    style Test fill:#E3F2FD,stroke:#1976D2,color:#0D47A1
    style Decision fill:#F19594,stroke:#E57373,color:#FFFFFF
    style Auth fill:#E3F2FD,stroke:#1976D2,color:#0D47A1
    style Params fill:#E3F2FD,stroke:#1976D2,color:#0D47A1
    style ProdTest fill:#E3F2FD,stroke:#1976D2,color:#0D47A1
    style Live fill:#E3F2FD,stroke:#1976D2,color:#0D47A1

```

### Sandbox Account Setup

Before starting integration, you need to obtain a sandbox account for API testing. For convenient integration, we will provide a public sandbox account for testing. Of course, you can also choose to log in to PingPong's <a href = "https://sandbox-checkout.pingpongx.com/" target = 'blank'> sandbox merchant backend </a> to register and obtain a new sandbox account.

::: note Note
If the merchant registers their own sandbox account, they need to provide account information to PingPong's technical support for some configuration before it can be used.
:::

### Determine Integration Solution

Before integration, you need to determine your integration solution. We provide multiple ways to integrate our API interface, ranging from pre-built hosted options to direct integrations where you control the payment experience yourself. We recommend choosing based on your desired level of page control, technical capabilities, and compliance readiness. For example, Hosted solutions support either rendering the checkout with the <a href="/en/notes/integrate/sdk-v4/">JS SDK</a> or using a <a href="/en/notes/integrate/link/">hosted payment page</a>; Non-Hosted solutions support both <a href="/en/notes/integrate/non-hosted-card/">Non-Hosted card payments</a> and <a href="/en/notes/integrate/non-hosted-apm/">Non-Hosted local payments (APM)</a>. If you choose the Non-Hosted card flow and handle cardholder data yourself, you need PCI-DSS certification and the ability to independently develop and maintain the checkout experience.

### API Authorization and Configuration

After completing sandbox testing, you need to contact PingPong's technical support for API authorization and configuration. Before authorization is completed, production accounts are unavailable. After API authorization is completed, you can log in to the <a href="https://checkout.pingpongx.com/aq/login">merchant backend</a> to obtain accId and secret key, and replace all sandbox environment configurations.

### Production Environment Integration

After completing sandbox environment testing, you will enter the website information review and necessary account configuration phase before production. After approval, production environment parameters will be issued. After obtaining production environment parameters, please complete the following items:
<ul>
<li>Replace sandbox environment parameters with production parameters.</li>
<li>Self-test payments and complete screenshots</li>
<li>Prepare a $1 product link</li>
</ul>

### Production Environment Verification
1. Send screenshots and product link, and notify technical support. The customer/technical support will initiate a real transaction test on the product link to verify the results;
2. After completing the real transaction test, the merchant needs to initiate a refund to verify the refund process;
3. After completing the above processes, website integration ends, payment channels officially go online, and payments become available.