Sphere Paysphere
Customer

Create Customer

POST
/v2/customer

Authorization

AuthorizationRequiredBearer <token>

In: header

Request Body

application/jsonOptional
typeRequiredstring

The type of customer that can be onboarded. Acceptable inputs are individual and business.

addressRequiredobject

The customer's address.

Header Parameters

Content-Typestring
curl -X POST "https://api.sandbox.spherepay.co/v2/customer" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "string",
    "address": {
      "line1": "string",
      "line2": "string",
      "city": "string",
      "postalCode": "string",
      "state": "string",
      "country": "string"
    }
  }'

OK

{
  "id": "customer_d41608fae4d34d308f85bc3c2b6ca29a",
  "type": "individual",
  "verificationProfiles": [
    {
      "name": "kyc_profile_a",
      "status": "incomplete",
      "criteria": {
        "complete": [],
        "pending": [
          "residential_address"
        ],
        "required": [
          "terms_of_service",
          "email_address",
          "first_name",
          "last_name",
          "date_of_birth",
          "photo_id",
          "identification_document"
        ],
        "errors": []
      }
    },
    {
      "name": "kyc_profile_b",
      "status": "incomplete",
      "criteria": {
        "complete": [],
        "pending": [
          "residential_address"
        ],
        "required": [
          "terms_of_service",
          "email_address",
          "first_name",
          "last_name",
          "date_of_birth",
          "photo_id",
          "identification_document",
          "proof_of_address"
        ],
        "errors": []
      }
    }
  ]
}