Get\Update\Delete Customer
These endpoints operate on a specific customer record identified by its UUID (customerId). Use Get Customer to retrieve the current state, Update Customer to replace the record's fields, and Delete Customer to permanently remove it.
Get Customer
Retrieves the full customer record for a given UUID.
Customer UUID
Successful
Customer UUID.
Company name of the customer. Required when billing.first_name and billing.last_name are not provided.
Unique identifier of the company recognised by the government. Known as CoC (Chamber of Commerce) number in some countries.
Consumer's email address.
Note: Required for 3DS. Please refer to the 3D Secure API specification for format requirements.
Entity ID on which the customer is created.
Cardholder's phone number.
^[0-9\s\-+().-]+$Customer's title (e.g. Mr, Mrs, Dr).
^[a-zA-Z\-\s.]+$Consumer's work phone number.
^[0-9\s\-+().-]+$Customer language preference for Invoice documents. See Localisation for details.
Timestamp when this customer was created.
Timestamp when this customer was last updated.
Bad Request
Unauthorized
Forbidden
Not Found
Internal Server Error
GET /oidc/customer-service/v2/customer/{customerId} HTTP/1.1
Host: emea.gsc.verifone.cloud
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*
{
"id": "123e4567-e89b-12d3-a456-426614174000",
"billing": {
"address_1": "text",
"address_2": "text",
"address_3": "text",
"city": "text",
"country_code": "text",
"first_name": "text",
"middle_name": "text",
"last_name": "text",
"phone": "text",
"postal_code": "text",
"state": "text"
},
"company_name": "text",
"company_registration_number": "text",
"email_address": "name@gmail.com",
"entity_id": "text",
"phone_number": "text",
"shipping": {
"address_1": "text",
"address_2": "text",
"address_3": "text",
"city": "text",
"first_name": "text",
"middle_name": "text",
"last_name": "text",
"phone": "text",
"country_code": "text",
"postal_code": "text",
"state": "text"
},
"title": "text",
"work_phone": "text",
"tax": {
"identifier": "text"
},
"language": "text",
"created_at": "2026-01-01T00:00:00.000Z",
"updated_at": "2026-01-01T00:00:00.000Z"
}How It Works
Obtain the customer UUID
The UUID is returned as id when the customer record is created. If you need to look up a UUID by email or name, use the List\Create Customers endpoint with an appropriate RSQL search filter.
Update Customer
Replaces the stored fields of an existing customer record. Pass only the fields you wish to change alongside the required entity_id.
Update replaces the record. Any field not included in the request body will be cleared. Always retrieve the current record first and merge your changes before sending.
Customer UUID
Company name of the customer. Required when billing.first_name and billing.last_name are not provided.
Unique identifier of the company recognised by the government. Known as CoC (Chamber of Commerce) number in some countries.
Consumer's email address.
Field required for: Klarna, PayPal
Note: Required for 3DS. Please refer to the 3D Secure API specification for format requirements.
Entity ID on which the customer is created. The Entity ID can be found at the organisation level as Organisation ID (Administration > Organizations > [Organization] > Organisation ID).
Cardholder's phone number.
^[0-9\s\-+().-]+$Customer's title (e.g. Mr, Mrs, Dr).
^[a-zA-Z\-\s.]+$Consumer's work phone number.
^[0-9\s\-+().-]+$Customer language preference for Invoice documents. See Localisation for details.
Successful
Customer UUID.
Company name of the customer. Required when billing.first_name and billing.last_name are not provided.
Unique identifier of the company recognised by the government. Known as CoC (Chamber of Commerce) number in some countries.
Consumer's email address.
Note: Required for 3DS. Please refer to the 3D Secure API specification for format requirements.
Entity ID on which the customer is created.
Cardholder's phone number.
^[0-9\s\-+().-]+$Customer's title (e.g. Mr, Mrs, Dr).
^[a-zA-Z\-\s.]+$Consumer's work phone number.
^[0-9\s\-+().-]+$Customer language preference for Invoice documents. See Localisation for details.
Timestamp when this customer was created.
Timestamp when this customer was last updated.
Bad Request
Unauthorized
Forbidden
Not Found
Internal Server Error
POST /oidc/customer-service/v2/customer/{customerId} HTTP/1.1
Host: emea.gsc.verifone.cloud
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 648
{
"billing": {
"address_1": "text",
"address_2": "text",
"address_3": "text",
"city": "text",
"country_code": "text",
"first_name": "text",
"middle_name": "text",
"last_name": "text",
"phone": "text",
"postal_code": "text",
"state": "text"
},
"company_name": "text",
"company_registration_number": "text",
"email_address": "name@gmail.com",
"entity_id": "text",
"phone_number": "text",
"shipping": {
"address_1": "text",
"address_2": "text",
"address_3": "text",
"city": "text",
"first_name": "text",
"middle_name": "text",
"last_name": "text",
"phone": "text",
"country_code": "text",
"postal_code": "text",
"state": "text"
},
"title": "text",
"work_phone": "text",
"tax": {
"identifier": "text"
},
"language": "text"
}{
"id": "123e4567-e89b-12d3-a456-426614174000",
"billing": {
"address_1": "text",
"address_2": "text",
"address_3": "text",
"city": "text",
"country_code": "text",
"first_name": "text",
"middle_name": "text",
"last_name": "text",
"phone": "text",
"postal_code": "text",
"state": "text"
},
"company_name": "text",
"company_registration_number": "text",
"email_address": "name@gmail.com",
"entity_id": "text",
"phone_number": "text",
"shipping": {
"address_1": "text",
"address_2": "text",
"address_3": "text",
"city": "text",
"first_name": "text",
"middle_name": "text",
"last_name": "text",
"phone": "text",
"country_code": "text",
"postal_code": "text",
"state": "text"
},
"title": "text",
"work_phone": "text",
"tax": {
"identifier": "text"
},
"language": "text",
"created_at": "2026-01-01T00:00:00.000Z",
"updated_at": "2026-01-01T00:00:00.000Z"
}Update workflow
Delete Customer
Permanently removes a customer record. This action cannot be undone.
Deleting a customer record is irreversible. Any downstream services or payment flows that reference this customer UUID will no longer be able to retrieve the associated data.
Customer UUID
Customer successfully deleted
No content
Bad Request
Unauthorized
Forbidden
Not Found
Internal Server Error
DELETE /oidc/customer-service/v2/customer/{customerId} HTTP/1.1
Host: emea.gsc.verifone.cloud
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*
No content
A successful delete returns 204 No Content with an empty body.
Get vs Update — Key Differences
Last updated
Was this helpful?