Swipelux
Customer API

Create a new customer

Create a new customer for a merchant

POST
/v1/customers

Authorization

X-API-Key<token>

In: header

Request Body

application/jsonOptional
firstNameRequiredstring

The first name of the customer

Minimum length: 1Maximum length: 1024
middleNamestring

The middle name of the customer

Minimum length: 1Maximum length: 1024
lastNameRequiredstring

The last name of the customer

Minimum length: 1Maximum length: 1024
emailRequiredstring

The primary email address of the customer

Format: "email"
phoneRequiredstring

The primary phone number of the customer in E.164 format (e.g., +1234567890)

Minimum length: 1Maximum length: 32
metadataobject

The provided metadata of the customer

birthDateRequiredstring

The date of birth of the customer in ISO 8601 format (YYYY-MM-DD)

Format: "date"
residentialAddressRequiredobject

The residential address of the customer

identifyingInformationRequiredarray<object>

An array of identifying information for the customer

Response Body

The customer was created successfully

idRequiredstring

A unique identifier for the customer

firstNameRequiredstring

The first name of the customer

Minimum length: 1Maximum length: 1024
middleNamestring

The middle name of the customer

Minimum length: 1Maximum length: 1024
lastNameRequiredstring

The last name of the customer

Minimum length: 1Maximum length: 1024
emailRequiredstring

The primary email address of the customer

Format: "email"
phoneRequiredstring

The primary phone number of the customer in E.164 format (e.g., +1234567890)

Minimum length: 1Maximum length: 32
statusRequiredunknown

The KYC verification status of the customer

Value in: "not_started" | "incomplete" | "under_review" | "approved" | "rejected"
metadataobject

The provided metadata of the customer

createdAtRequiredstring

The creation date of the customer

Format: "date-time"
updatedAtRequiredstring

The last update date of the customer

Format: "date-time"
export interface Response {
  /**
   * A unique identifier for the customer
   */
  id: string;
  /**
   * The first name of the customer
   */
  firstName: string;
  /**
   * The middle name of the customer
   */
  middleName?: string;
  /**
   * The last name of the customer
   */
  lastName: string;
  /**
   * The primary email address of the customer
   */
  email: string;
  /**
   * The primary phone number of the customer in E.164 format (e.g., +1234567890)
   */
  phone: string;
  /**
   * The KYC verification status of the customer
   */
  status: "not_started" | "incomplete" | "under_review" | "approved" | "rejected";
  /**
   * The provided metadata of the customer
   */
  metadata?: {
    [k: string]: string | number | boolean;
  };
  /**
   * The creation date of the customer
   */
  createdAt: string;
  /**
   * The last update date of the customer
   */
  updatedAt: string;
}
 
curl -X POST "https://wallet.swipelux.com/v1/customers" \
  -H "X-API-Key: <token>" \
  -H "Content-Type: application/json" \
  -d '{
    "firstName": "string",
    "middleName": "string",
    "lastName": "string",
    "email": "user@example.com",
    "phone": "string",
    "metadata": {
      "property1": "string",
      "property2": "string"
    },
    "birthDate": "2019-08-24",
    "residentialAddress": {
      "streetLine1": "string",
      "streetLine2": "string",
      "city": "string",
      "state": "string",
      "postalCode": "string",
      "country": "str"
    },
    "identifyingInformation": [
      {
        "type": "drivers_license",
        "issuingCountry": "str",
        "frontSideImage": "string",
        "backSideImage": "string"
      }
    ]
  }'
{
  "id": "string",
  "firstName": "string",
  "middleName": "string",
  "lastName": "string",
  "email": "user@example.com",
  "phone": "string",
  "status": "not_started",
  "metadata": {
    "property1": "string",
    "property2": "string"
  },
  "createdAt": "2019-08-24T14:15:22Z",
  "updatedAt": "2019-08-24T14:15:22Z"
}