创建买家
POST
Request Body Parameters
application/json公共请求参数
bizContent
addressObject可选地址对象。countryString(2)可选国家二字码，ISO 3166 标准。stateString(128)可选州/省。cityString(50)可选城市。postalCodeString(16)可选邮编。line1String(256)可选地址行 1。line2String(256)可选地址行 2。
requestIdString(64)必填唯一请求号，全局唯一。partnerCustomerIdString(64)必填商户侧买家标识，用户在商户网站的会员 ID，同店铺内唯一。firstNameString(64)可选名。lastNameString(64)可选姓。companyNameString(128)可选公司名。emailString(128)可选邮箱。phoneString(20)可选电话。languageString(12)可选偏好语言地区。metadataString(512)可选商户自定义串。
请求报文示例
{
"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"
}
}Responses Body Parameters
application/json公共返回参数
bizContent
addressObject可选地址对象，结构同请求 address。countryString(2)可选国家二字码，ISO 3166 标准。stateString(128)可选州/省。cityString(50)可选城市。postalCodeString(16)可选邮编。line1String(256)可选地址行 1。line2String(256)可选地址行 2。
requestIdString(64)必填唯一请求号，回显请求。customerIdString(64)必填PingPong 买家 ID。partnerCustomerIdString(64)必填商户侧买家标识，用户在商户网站的会员 ID，同店铺内唯一。firstNameString(64)可选名。lastNameString(64)可选姓。companyNameString(128)可选公司名。emailString(128)可选邮箱。phoneString(20)可选电话。languageString(12)可选偏好语言地区。metadataString(512)可选商户自定义串。createdAtString(10)必填创建时间，10 位秒级时间戳字符串。updatedAtString(10)必填更新时间，10 位秒级时间戳字符串。
响应报文示例
{
"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"
}
}