v1

latestOpenAPI 3.0.02026-07-26168846732.2 KB

Customers

Customers - Retrieve using Merchant Reference ID

Retrieves a customer's details using the merchant supplied reference ID.

get/v1/customers/reference/{merchant_reference_id}

Path parameters

merchant_reference_idstring required

The merchant supplied reference identifier for the Customer

Response

Customer Retrieved

idstring required

Unique identifier for the customer

merchant_reference_idstring required

The identifier for the customer object

connector_customer_idsobject nullable

Connector specific customer reference ids

namestring nullable

The customer's name

emailstring nullable

The customer's email address

phonestring nullable

The customer's phone number

phone_country_codestring nullable

The country code for the customer phone number

descriptionstring nullable

An arbitrary string that you can attach to a customer object.

created_atstring date-time required

A timestamp (ISO 8601 code) that determines when the customer was created

metadataobject nullable

You can specify up to 50 keys, with key names up to 40 characters long and values up to 500 characters long. Metadata is useful for storing additional, structured information on an object.

default_payment_method_idstring nullable

The identifier for the default payment method.

tax_registration_idstring nullable

The customer's tax registration number.

Example response

{
  "id": "0a_cus_01926c58bc6e77c09e809964e72af8c8",
  "merchant_reference_id": "cus_y3oqhf46pyzuxjbcn2giaqnb44",
  "name": "Jon Test",
  "email": "JonTest@test.com",
  "phone": "9123456789",
  "phone_country_code": "+65",
  "description": "First Customer",
  "default_billing_address": {
    "city": "New York",
    "line1": "123, King Street",
    "line2": "Powelson Avenue",
    "line3": "Bridgewater",
    "zip": "08807",
    "state": "New York",
    "first_name": "John",
    "last_name": "Doe",
    "origin_zip": "08807"
  },
  "default_shipping_address": {
    "city": "New York",
    "line1": "123, King Street",
    "line2": "Powelson Avenue",
    "line3": "Bridgewater",
    "zip": "08807",
    "state": "New York",
    "first_name": "John",
    "last_name": "Doe",
    "origin_zip": "08807"
  },
  "created_at": "2023-01-18T11:04:09.922Z",
  "default_payment_method_id": "0a_pm_01926c58bc6e77c09e809964e72af8c8",
  "tax_registration_id": "123456789",
  "document_details": {
    "document_number": "12345678911"
  }
}