更新买家
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)必填唯一请求号,全局唯一。customerIdString(64)必填PingPong 买家 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_0002",
"customerId": "CUS-260507100000000001",
"email": "james.new@example.com",
"phone": "13800138001"
}
}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_0002",
"customerId": "CUS-260507100000000001",
"partnerCustomerId": "USER_001",
"firstName": "James",
"lastName": "LeBron",
"email": "james.new@example.com",
"language": "en",
"createdAt": "2026-05-07T00:00:00Z",
"updatedAt": "2026-05-08T00:00:00Z"
}
}