v1

latestOpenAPI 3.0.32026-07-248079274.0 KB

Customers

Create a customer

The purpose of creating a customer is so that everything can be linked back to a customer_id. All transactions, beneficiaries, cards etc. are associated to a customer. Creating a customer at the start of the process allows us to manage your customers for you.

post/customers

Headers

Company-Idstring uuid

Unique ID assigned by Acquired.com for your company.

Request body

company_idstring uuid

Unique ID assigned by Acquired.com to the company the customer belongs token.

referencestring

Unique reference assigned by you for the customer when it is created.

first_namestring

The customer's first name.

last_namestring

The customer's last name. Required for MCC 6012 merchants.

dobstring date

The customer's date of birth. Required for MCC 6012 merchants.

custom_datastring

Base64 encoded string detailing custom data passed in the request.

createdstring date-time

The date and time at which the customer was created.

last_updatedstring date-time

The date and time the customer record was last updated.

Example request

{
  "reference": "customer_number_00001",
  "first_name": "Edward",
  "last_name": "Johnson",
  "dob": "1988-10-03",
  "custom_data": "L3BheW1lbnQtbGlua3MgcGF5IGN1c3RvbV9kYXRh",
  "billing": {
    "address": {
      "line_1": "152 Aldgate Drive",
      "city": "London",
      "postcode": "E1 7RT",
      "country_code": "GB"
    },
    "email": "ejohnson@acquired.com",
    "phone": {
      "country_code": "44",
      "number": "2039826580"
    }
  },
  "shipping": {
    "address": {
      "line_1": "152 Aldgate Drive",
      "city": "London",
      "postcode": "E1 7RT",
      "country_code": "GB"
    },
    "email": "ejohnson@acquired.com",
    "phone": {
      "country_code": "44",
      "number": "2039826580"
    }
  }
}

Response

Created

customer_idstring uuid

Unique ID assigned by Acquired.com to the customer when it is created.