Skip to content
API reference
/Customer/
Create or update customer

Create or update customer

Request

Creates or updates a customer for the authenticated merchant. Calling again with the same externalUserId updates the existing customer. customerGroups and kyc.kycLevels drive PSP eligibility — see Routing & PSP Eligibility.

Security
bearerAuth
Bodyapplication/jsonrequired

Create customer request

externalUserIdstringrequired

Your unique identifier for this customer. Calling the customer endpoint again with the same value updates the existing customer.

Example:"3183818381183"
firstNamestringrequired

Customer first name.

Example:"John"
lastNamestringrequired

Customer last name.

Example:"Doe"
emailstringrequired

Customer email.

Example:"john.doe@example.com"
phoneNumberstringrequired

Customer phone number.

Example:"1 1234567890"
dateOfBirthstring, (date)required

Customer date of birth.

Example:"1990-12-01"
userNamestring

Customer username.

Example:"John123"
customerGroupsArray of strings

Customer groups the customer belongs to. Merchant-defined string labels, matched against each provider's group rules during eligibility filtering.

Example:
[
  "Vipgroup"
]
billingobject(CustomerBilling)required

Customer billing information

kycobject(CustomerKyc)

Customer KYC information

curl -i -X POST \
  https://api.omno.com/v3/public/customer \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "externalUserId": "3183818381183",
    "firstName": "John",
    "lastName": "Doe",
    "email": "john.doe@example.com",
    "phoneNumber": "1 1234567890",
    "dateOfBirth": "1990-12-01",
    "userName": "John123",
    "customerGroups": [
      "Vipgroup"
    ],
    "billing": {
      "address": "123 Main St",
      "city": "Atlanta",
      "state": "GA",
      "countryCode": "US",
      "postalCode": "30308"
    },
    "kyc": {
      "idType": "passport",
      "idNumber": "A12345678",
      "idCountry": "US",
      "idExpirationDate": "2030-12-31",
      "nationality": "US",
      "countryOfBirth": "US",
      "kycLevels": [
        "Identity Check",
        "Mail Verification"
      ],
      "allowBypass": true
    }
  }'

Responses

Customer created or updated

Bodyapplication/json
idstringrequired

Omno customer ID.

Example:"123456789"
firstNamestringrequired

Customer first name.

Example:"John"
lastNamestringrequired

Customer last name.

Example:"Doe"
externalUserIdstringrequired

Merchant-specified customer external user ID.

Example:"3183818381183"
merchantIdstringrequired

Merchant ID associated with the customer.

Example:"123456789"
emailstringrequired

Customer email.

Example:"john.doe@example.com"
phoneNumberstringrequired

Customer phone number.

Example:"1 1234567890"
dateOfBirthstringrequired

Customer date of birth (YYYY-MM-DD).

Example:"1990-12-01"
Response
{
  "id": "123456789",
  "firstName": "John",
  "lastName": "Doe",
  "externalUserId": "3183818381183",
  "merchantId": "123456789",
  "email": "john.doe@example.com",
  "phoneNumber": "1 1234567890",
  "dateOfBirth": "1990-12-01"
}