---
url: >-
  https://acquirer-api-docs-v4-en.pingpongx.com/en/notes/subscription/invoice/customer/create/index.md
description: >-
  The Create Customer API creates a customer record from the merchant-side
  customer identifier (partnerCustomerId) and returns the PingPong customer ID
  (customerId) for later subscription and invoicing scenarios.
---
# Create Customer

```apidef
endpoint: POST /v4/customers/create
name: Create Customer
summary: Create a customer and get the PingPong customer ID
tags: Invoice, Customer
```

The Create Customer API creates a customer record from the merchant-side customer identifier (partnerCustomerId) and returns the PingPong customer ID (customerId) for later subscription and invoicing scenarios.

## Request Parameters

| Parameter | Type | Required | Description |
|--------|------|------|------|
| clientId | string | M | Merchant ID. |
| accId | string | M | Store ID. |
| signType | string | M | Signature type, MD5; for details, see the Signature Specification: /en/notes/guide/sign/ section of this document. |
| sign | string | M | Signature value, following the V4 signature specification. All parameters participate in the signature. |
| version | string | M | API version, fixed at 4.0 . |
| bizContent | string | M | Business parameters as a JSON string. All request parameters except the common ones must be passed within this parameter. |
| └─ requestId | string | M | Unique request ID, globally unique. |
| └─ partnerCustomerId | string | M | Merchant-side customer identifier, i.e. the user's member ID on the merchant's website. Unique within the same store. |
| └─ firstName | string | O | First name. |
| └─ lastName | string | O | Last name. |
| └─ companyName | string | O | Company name. |
| └─ email | string | O | Email address. |
| └─ phone | string | O | Phone number. |
| └─ address | object | O | Address object. |
| └─ └─ country | string | O | Two-letter country code, ISO 3166. |
| └─ └─ state | string | O | State or province. |
| └─ └─ city | string | O | City. |
| └─ └─ postalCode | string | O | Postal code. |
| └─ └─ line1 | string | O | Address line 1. |
| └─ └─ line2 | string | O | Address line 2. |
| └─ language | string | O | Preferred language and locale. |
| └─ metadata | string | O | Merchant-defined custom string. |

### Request Example

```json
{
  "clientId": "20250101123456",
  "accId": "ACC001",
  "signType": "MD5",
  "sign": "SIGN_VALUE",
  "version": "4.0",
  "bizContent": "{\"requestId\":\"req_20260507_0001\",\"partnerCustomerId\":\"USER_001\",\"firstName\":\"James\",\"lastName\":\"LeBron\",\"companyName\":\"Example Inc.\",\"email\":\"james@example.com\",\"phone\":\"13800138000\",\"address\":{\"country\":\"US\",\"state\":\"CA\",\"city\":\"San Jose\",\"postalCode\":\"95113\",\"line1\":\"101 First Street\",\"line2\":\"Suite 200\"},\"language\":\"en\",\"metadata\":\"vip-user\"}"
}
```

## Response Parameters

| Parameter | Type | Description |
|--------|------|------|
| clientId | string | Merchant ID. |
| accId | string | Store ID. |
| signType | string | Signature type. |
| sign | string | Signature value, verified using the V4 signature specification. |
| code | string | Response code: 000000 on success; on failure, the business error code is passed through ( 102000 invalid parameter / 500003 resource not found / 910001 business validation failed / 910005 operation not allowed in current status / 910008 in-flight task exists / 500000 system error, etc.). |
| description | string | Response description. |
| bizContent | string | Business response as a JSON string. |
| └─ requestId | string | Unique request ID, echoed from the request. |
| └─ customerId | string | PingPong customer ID. |
| └─ partnerCustomerId | string | Merchant-side customer identifier, i.e. the user's member ID on the merchant's website. Unique within the same store. |
| └─ firstName | string | First name. |
| └─ lastName | string | Last name. |
| └─ companyName | string | Company name. |
| └─ email | string | Email address. |
| └─ phone | string | Phone number. |
| └─ address | object | Address object, same structure as the request address. |
| └─ └─ country | string | Two-letter country code, ISO 3166. |
| └─ └─ state | string | State or province. |
| └─ └─ city | string | City. |
| └─ └─ postalCode | string | Postal code. |
| └─ └─ line1 | string | Address line 1. |
| └─ └─ line2 | string | Address line 2. |
| └─ language | string | Preferred language and locale. |
| └─ metadata | string | Merchant-defined custom string. |
| └─ createdAt | string | Creation time as a 10-digit second-level timestamp string. |
| └─ updatedAt | string | Last update time as a 10-digit second-level timestamp string. |

### Response Example

```json
{
  "clientId": "20250101123456",
  "accId": "ACC001",
  "signType": "MD5",
  "sign": "SIGN_VALUE",
  "code": "000000",
  "description": "SUCCESS",
  "bizContent": "{\"requestId\":\"req_20260507_0001\",\"customerId\":\"CUS-260507100000000001\",\"partnerCustomerId\":\"USER_001\",\"firstName\":\"James\",\"lastName\":\"LeBron\",\"email\":\"james@example.com\",\"language\":\"en\",\"createdAt\":\"2026-05-07T00:00:00Z\",\"updatedAt\":\"2026-05-07T00:00:00Z\"}"
}
```