Verifying unverified customer - webhooks

API Support Customers
1

Hi,

In my application I want to create the unverified customer and then upgrade to verified one.
First, I’m doing request:
POST /customers

{
  "firstName": "Jane",
  "lastName": "Doe",
  "email": "jane@unverified.net",
  "ipAddress": "99.99.99.99",
  "businessName": "Jane Merchant's Business"
}

Then I should receive customer_created webhook.

According to what I read in your docs to verify the unverified customer I need to make following request:
POST /customers/customer_id

{
  "firstName": "Jane",
  "lastName": "Doe",
  "email": "jane@unverified.net",
  "ipAddress": "99.99.99.99",
  "type": "personal",
  "address1": "99-99 Correction St",
  "city": "Some City",
  "state": "NY",
  "postalCode": "11101",
  "dateOfBirth": "1970-01-01",
  "ssn": "123456789"
}

Will I receive another customer_created webhook in this case?
Is this correct flow? Or should I do this in a different way?

2

Hi @klaudia.on!

That’s the correct flow! Howeerver, the webbhooks you will reeceive is as follows,

Unverified Customer created

  • customer_created

Upgraded to Verified Customer (depending on what verification status they fall into)

  • customer_verified (verified status)
  • customer_reverification_needed (retry status)
  • customer_verification_document_needed (document status)
  • customer_suspended (suspended status)

Check out our guide to understand what each status means and how to handle them. Alternatively, you can use our Drop-in components to create Verified Customers and handle the different statuses.