Wildberries API TypeScript SDK / CustomerVerificationError

Class: CustomerVerificationError

Defined in: errors/in-store-pickup-errors.ts:173

Error thrown when customer identity verification fails

HTTP Status: 409 Conflict Retry: No (permanent failure - requires correct passcode) Rate Limit: 409 responses count as 10 requests!

This error occurs when the passcode provided for identity verification does not match the customer's order code. The customer needs to provide the correct passcode from their Wildberries app.

Example

try {
  const result = await sdk.inStorePickup.verifyCustomerIdentity({
    orderCode: '21117866-0006',
    passcode: '1234'
  });
} catch (error) {
  if (error instanceof CustomerVerificationError) {
    console.error('Verification failed:', error.getUserMessage());
    // Ask customer to check their app for correct passcode
    // Note: Be careful not to exceed rate limits (30 req/min)
  }
}

Extends

• WBAPIError

Constructors

Constructor

new CustomerVerificationError(
   orderCode: string, 
   message: string, 
   requestId?: string): CustomerVerificationError;

Defined in: errors/in-store-pickup-errors.ts:181

Creates a new CustomerVerificationError

Parameters

Parameter	Type	Description
orderCode	string	Customer's order code that failed verification
message	string	Detailed error message from API
requestId?	string	Optional request ID from API response

Returns

CustomerVerificationError

Overrides

WBAPIError.constructor

Properties

Property	Modifier	Type	Description	Inherited from	Defined in
<a id="statuscode"></a> statusCode?	readonly	number	HTTP status code if applicable	WBAPIError.statusCode	errors/base-error.ts:25
<a id="response"></a> response?	readonly	unknown	API response body if available	WBAPIError.response	errors/base-error.ts:30
<a id="requestid"></a> requestId?	readonly	string	Correlation ID for debugging and tracing requests	WBAPIError.requestId	errors/base-error.ts:35
<a id="origin"></a> origin?	readonly	string	Origin service identifier from RFC 7807 problem+json responses. Indicates which internal Wildberries service originated the error (e.g., "s2s-api-auth-catalog").	WBAPIError.origin	errors/base-error.ts:43
<a id="timestamp"></a> timestamp?	readonly	string	ISO 8601 timestamp from RFC 7807 problem+json responses. Indicates when the error occurred on the server side (e.g., "2024-09-30T06:52:38Z").	WBAPIError.timestamp	errors/base-error.ts:51
<a id="ordercode"></a> orderCode	readonly	string	Customer's order code that failed verification	-	errors/in-store-pickup-errors.ts:182

Methods

toJSON()

toJSON(): {
  name: string;
  message: string;
  statusCode?: number;
  response?: unknown;
  requestId?: string;
  origin?: string;
  timestamp?: string;
};

Defined in: errors/base-error.ts:156

Custom JSON serialization to preserve all error properties.

By default, Error objects don't serialize the message property when using JSON.stringify(). This method ensures all important properties are included in the JSON output.

Returns

{
  name: string;
  message: string;
  statusCode?: number;
  response?: unknown;
  requestId?: string;
  origin?: string;
  timestamp?: string;
}

Object representation of the error for JSON serialization

Name	Type	Defined in
name	string	errors/base-error.ts:157
message	string	errors/base-error.ts:158
statusCode?	number	errors/base-error.ts:159
response?	unknown	errors/base-error.ts:160
requestId?	string	errors/base-error.ts:161
origin?	string	errors/base-error.ts:162
timestamp?	string	errors/base-error.ts:163

Example

const error = new WBAPIError('Test error', 400, { detail: 'info' }, 'req-123');
const json = JSON.stringify(error);
// { "name": "WBAPIError", "message": "Test error", "statusCode": 400, ... }

Inherited from

WBAPIError.toJSON

---

getUserMessage()

getUserMessage(): string;

Defined in: errors/in-store-pickup-errors.ts:201

Returns user-friendly error message with recovery guidance

Returns

string

Overrides

WBAPIError.getUserMessage