---
title: "Create Customer"
method: POST
path: "/pws/pws_create_customer"
tags: ["Customer"]
---

# Create Customer

`POST /pws/pws_create_customer`

This web service creates a new customer/cardholder

## Request body

- PwsCustomerModel
  - `api_call_unique_identifier` string, required — Unique number that must be passed at each API request. Identifier to make each API request unique
  - `client_id` integer, required — Unique identifier for the client which Paymentology will provide at outset
  - `cu_fname` string, required — Customer First Name
  - `cu_mobile` string, required — Customer Mobile Number. mobile number format i.e 00 (country code) phone number or + (country code) phone number.
  - `cu_sname` string, required — Customer Last Name
  - `user_id` string — User Id of the Customer who triggered the API request.
  - `remarks` string — Remarks for API request
  - `cu_title` string
  - `company` string — Customer Company
  - `cu_ref` string — Customer Ref
  - `cu_bldg_no` string — Customer building number
  - `cu_add1` string — Customer address1
  - `cu_add2` string — Customer address2
  - `cu_add3` string — Customer Address3
  - `cu_pcode` string — Customer PCode
  - `cu_city` string — Customer City Name
  - `cu_country` string — Customer Country Name
  - `cu_email` string, email — Customer Email
  - `cu_pass_code` string — Customer Pass Code
  - `cu_lang` string — Customer Native Language
  - `cu_nationality` string — Customer Nationality
  - `cu_gender` integer — <p>Customer Gender.Possible values are:</p><ul><li>1=Male</li><li>2=Female</li><li>3=Other</li></ul>
  - `cu_alternate_email` string, email — Customer Alternate Email
  - `cu_state` string — Customer State
  - `cu_dob` string — Customer Date of Birth
  - `default_rule_alert_sms_severity` integer — Default rule alert sms severity
  - `default_rule_alert_email_severity` integer — Default rule alert email severity
  - `bank_customer_no` string — Bank Customer Number
  - `cu_alternate_mobile` string — Customer Alternate Mobile
  - `cu_phone_home` string — Customer Phone Home
  - `cu_id_type` string — Customer Id Type
  - `cu_id_number` string — Customer id number can be driving licence,citizenship number
  - `credit_rating` number, double — Credit rating
  - `credit_rating_source` integer — Credit rating source
  - `display_name` string — Display Name
  - `kyc_status` string — <p>KYC status</br>possible options are:</p><ul><li>1 =Awaiting first verification attempt</li> <li>2 = KYC data submitted, Awaiting Response</li> <li>3 = KYC successful</li> <li>4 = KYC unsuccessful</li> <li>5 = KYC verification attempts expired</li> <li>6 = KYC not possible (permeant)</li> <li>7=Awaiting KYC re-verification</li></ul>
  - `kyc_status_details` string — <p>KYC status details.</br>User defined text to describe the reason of status</p>
  - `kyc_ext_reference` string — External reference id provided by KYC provider to refer last KYC attempt
  - `key_provider_name` string — <p>Key provider name.</br>Possible options are:</p><ul><li>1 = Jumio (supported for now)</li> <li>2 = IDNow</li> <li>3 = Sumsub</li></ul>
  - `kyc_attempt_count` integer — Counter which is decremented with each KYC attempt
  - `kyc_attempt_date` string — Date with timestamp . It will contain the value when last KYC attempt was made
  - `is_main_cardholder` boolean — <p>Indicates if the customer to be created is main cardholder or not.</br>The possible values are true or false.</p>

## Response `200`

Successful Response

- CustomerCreateResponse
  - `header` CustomerCreateHeader
    - `error_id` integer — error id
    - `error_desc` string — error message
  - `body` CustomerCreateBody
    - `customer_id` integer — Customer Id

## Other responses

- `404` — Webservices does not exist
- `500` — Internal Server error

---

[API](https://skmtc.net/paymentology/apis/payapi-docs.md) · [All operations](https://skmtc.net/paymentology/apis/payapi-docs/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/paymentology/payapi-docs/revisions/a675891b0365/schema)