Create Customer
curl --request POST \
--url https://api.atoa.me/api/customers \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
"fullName": "John Doe",
"email": "john.doe@example.com",
"type": "INDIVIDUAL",
"phoneCountryCode": "44",
"phoneNumber": "7911123456",
"address": "123 High Street",
"city": "London",
"postcode": "SW1A 1AA"
}'
{
"id": "550e8400-e29b-41d4-a716-446655440000",
"fullName": "John Doe",
"email": "john.doe@example.com",
"type": "INDIVIDUAL",
"phoneCountryCode": "44",
"phoneNumber": "7911123456",
"address": "123 High Street",
"city": "London",
"postcode": "SW1A 1AA",
"createdAt": "2025-06-15T10:30:00.000Z"
}
Create a customer if you want to save card details and make future payments. Guest checkout or one-off payment doesn’t mandate you to create a customer.
For high-value card payment, we might collect customer details in the UI for a high success rate.
Authorization
Bearer <accessSecret>
Request Body Schema
Customer’s full name. Must be 2-30 characters and not blank.
Customer’s email address. Must be a valid email format. Either email or phone number is required.
Customer type.
Phone country code, digits only. Max 5 characters. Example: 44 for UK.
Phone number without country code, digits only. Max 15 characters.
Customer’s address. Max 100 characters.
Customer’s city. Max 30 characters.
Customer’s postcode. 4-8 characters, letters, numbers and spaces only. Example: SW1A 1AA.
VAT number for business customers. Must be 9 digits, optionally prefixed with GB. Example: 123456789 or GB123456789.
Response
Unique identifier for the customer (UUID).
Customer’s full name.
Customer’s email address.
Customer type (INDIVIDUAL or BUSINESS).
Phone country code.
Phone number.
Customer’s address.
Customer’s city.
Customer’s postcode.
VAT number (business customers only).
ISO 8601 creation timestamp.
curl --request POST \
--url https://api.atoa.me/api/customers \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
"fullName": "John Doe",
"email": "john.doe@example.com",
"type": "INDIVIDUAL",
"phoneCountryCode": "44",
"phoneNumber": "7911123456",
"address": "123 High Street",
"city": "London",
"postcode": "SW1A 1AA"
}'
{
"id": "550e8400-e29b-41d4-a716-446655440000",
"fullName": "John Doe",
"email": "john.doe@example.com",
"type": "INDIVIDUAL",
"phoneCountryCode": "44",
"phoneNumber": "7911123456",
"address": "123 High Street",
"city": "London",
"postcode": "SW1A 1AA",
"createdAt": "2025-06-15T10:30:00.000Z"
}