API referencePay In endpointsCustomer

Get customer

Retrieves a customer's record and details.

Path parameters

customerIdintegerRequired

Payabli-generated customer ID. Maps to “Customer ID” column in PartnerHub.

Headers

requestTokenstringRequired

Response

Success
AdditionalFieldsmap from strings to optional strings or null

List of additional custom fields in format key:value.

Addressstring or null
Customer address.
Address1string or null
Additional line for customer address.
Balancedouble or null
Customer balance.
Citystring or null
Customer city.
Companystring or null
Company name.
Countrystring or null
Customer country.
Createddatetime or null
Date and time created.
customerConsentobject or null
customerIdlong or null

The Payabli-generated unique ID for the customer.

customerNumberstring or null<=250 characters

User-provided unique identifier for the customer. This is typically the customer ID from your own system.

customerStatusinteger or null

Customer Status. Possible values:

  • -99 Deleted
  • 0 Inactive
  • 1 Active
  • 85 Locked (typically due to multiple failed login attempts)
customerSummaryobject or null
customerUsernamestring or null
Username for customer.
Emailstring or nullformat: "email"<=320 characters
Customer email address.
externalPaypointIDstring or null

A custom identifier for the paypoint, if applicable. Like entrypoint is the Payabli identifier for the merchant, externalPaypointId is a custom field you can use to include the merchant’s ID from your own systems.

Firstnamestring or null
Customer first name.
IdentifierFieldslist of optional strings or null
List of fields acting as customer identifiers, to be used instead of CustomerNumber.
Lastnamestring or null
Customer last name.
LastUpdateddatetime or null
Date and time of last update.
MFAboolean or null

When true, multi-factor authentication (MFA) is enabled.

MFAModeinteger or null
pageidentifierstring or null
Auxiliary validation used internally by payment pages and components.
ParentOrgNamestring or null
The name of the parent organization.
PaypointDbanamestring or null
Paypoint DBA name.
PaypointEntrynamestring or null<=50 characters
The entrypoint identifier.
PaypointLegalnamestring or null
Paypoint legal name.
Phonestring or null
Customer phone number.
ShippingAddressstring or null<=250 characters
The shipping address.
ShippingAddress1string or null<=100 characters
Additional line for shipping address.
ShippingCitystring or null<=250 characters
Shipping city.
ShippingCountrystring or null
Shipping address country.
ShippingStatestring or null
Shipping state or province.
ShippingZipstring or null<=50 characters

Shipping ZIP code. For Pay In functions, this field supports 5-digit and 9-digit ZIP codes and alphanumeric Canadian postal codes. For example: “37615-1234” or “37615”.

snDatastring or null
Additional data provided by the social network related to the customer.
snIdentifierstring or null
Identifier or token for customer in linked social network.
snProviderstring or null

Social network linked to customer.
Possible values:

  • facebook
  • google
  • twiter
  • microsoft
Statestring or null
Customer state.
StoredMethodslist of objects or null
List of payment methods associated to the customer.
Subscriptionslist of objects or null
List of subscriptions associated to the customer.
TimeZoneinteger or null

Timezone, in UTC offset. For example, -5 is Eastern time.

Zipstring or null
Customer zip code.

Errors