---
title: "Create credit customer"
method: POST
path: "/customer"
tags: ["Customers"]
---

# Create credit customer

`POST /customer`

## Request

- Base URL: `http://<host-url>`
- URL: `http://<host-url>/customer`
- Auth: HTTP bearer

Creates a new credit card customer record in Lume and PayCredit

## Headers

- `unique-request-id` string

## Request body

- CreateCustomerGenericRequestDto
  - `cu_fname` string, required: Customer first name
  - `cu_mobile` string, required: Customer mobile number in PayCredit format: starts with + followed by 7 to 15 digits, with optional spaces between digits.
  - `cu_ref` string: Optional client provided reference, if provided must be unique
  - `cu_sname` string, required: Customer last name

## Response `200`

Customer created in Lume; PayCredit creation queued with warning_message

- CreateCustomerGenericResponseDto
  - `customer_id` integer: Unique customer identifier in Lume and PayCredit systems
  - `warning_message` string: Warning message when PayCredit creation could not be completed synchronously

## Other responses

- `201`: Customer successfully created
- `400`: Invalid Customer Request
- `500`: Server Error

---

[API](https://skmtc.dev/paymentology/apis/paycredit-api.md) - [All operations](https://skmtc.dev/paymentology/apis/paycredit-api/llms.txt) - [OpenAPI document](https://skmtc.dev/paymentology/apis/paycredit-api/revisions/cc56df9c933b?raw)