Customer

The Customer API stores and manages shopper personal, billing, and shipping details in a single place. Each customer record is identified by a UUID that can be passed to other Verifone services — including Checkout, eCom, and 3D Secure — wherever customer data is required.

A customer record is not always required to process a payment. However, providing one unlocks fraud scoring, APM support (PayPal, Klarna, and others), 3DS authentication, and richer reporting in Verifone Central.

Environments

Environment

Base URL

EMEA Production

https://emea.gsc.verifone.cloud/oidc/customer-service

Americas Production

https://us.gsc.verifone.cloud/oidc/customer-service

New Zealand Production

https://nz.gsc.verifone.cloud/oidc/customer-service

Global Sandbox

https://cst.test-gsc.vfims.com/oidc/customer-service

US Sandbox

https://uscst-gb.gsc.vficloud.net/oidc/customer-service

Authentication

All endpoints support both Bearer (JWT) and Basic Auth. See your Verifone onboarding documentation for credential details.

API Reference

Name

List & Create Customers

Description

Search for existing customers using RSQL filters, or create a new customer record.

Name

Get, Update & Delete Customers

Description

Retrieve a customer by UUID, update their details, or permanently delete a record.

Name

FAQs

Description

Common questions about when and why to use customer records.

Quick Start

Create a customer record

Send a POST /v2/customer request with the shopper's billing details and your entity_id.

Store the customer UUID

The response returns an id field containing the customer UUID. Persist this value — you will pass it to Checkout, eCom, or 3DS when processing payments for this shopper.

Use the UUID in downstream services

Pass the customer UUID to the Checkout or eCom API request body wherever customer data is accepted. For 3DS flows, ensure billing address fields are populated on the record.

PreviousBin NextGet\Update\Delete Customer

Last updated 19 days ago

Was this helpful?