/v2/customers
Creates a new customer that can be set up with payment method sources and can make payments.
Each customer should represent a unique individual or corporate body.
If a customer is resetting a payment method, edit the payment method on the existing customer.
Duplicate customer entities may lead to failed payment initiation and incorrect fraud flagging.
The mobile and email for the customer must be unique across your Stronghold Pay account. At least one of mobile or email is required.
The country should be set retail or delivery location for the customer’s orders, being the merchant’s country in the
case of goods pickup or where services are being provided. state must be provided if the country is US; otherwise,
it may be omitted. For a list of valid countries, states, and territories, see Countries.
You can link a Stronghold Pay customer entity to your internal customer users in two ways:
- track the
customer.idreturned from the API; or, - send your own customer ID as the
external_idwhen creating acustomer.
Request Body
The ISO 3166 alpha-2 country code to assign to the customer. For individuals, pick the country of order/service delivery, or the merchant’s country for pick up.
If the country is set to ‘US’, the state for the customer.
An integrator-specific alphanumeric ID to assign to the customer. Useful if not saving the Stronghold-generated customer ID. Can use numbers, letters, underscores and dashes.
Responses
The newly created customer.
The response ID.
The response time.
The HTTP status code.