Validate an App Registration Phone Validation

PUT https://api.verifik.co/v2/phone-validations

This endpoint validates a one-time password (OTP) sent to a user's phone number during the app registration (onboarding) process. It ensures the user-provided OTP is correct and updates the verification status accordingly. This route is specifically designed for users who are in the middle of an app registration flow.

Headers

Name
Value

Content-Type

application/json

Authorization

Bearer {YOUR_ACCESS_TOKEN}

Body

Name
Type
Required
Description

phone

string

Yes

The phone number that was used to create the phone validation.

countryCode

string

Yes

The country code of the phone number in format +XXX (e.g., +507 for Panama).

otp

number

Yes

The one-time password (OTP) that was sent to the user's phone number.

project

string

No

The unique identifier for the project (optional, helps narrow down the validation).

projectFlow

string

No

The unique identifier for the project flow (optional, helps narrow down the validation).

phoneGateway

string

No

The delivery method used: sms, whatsapp, or none.

Body Examples

Basic Validation

{
  "phone": "62647737",
  "countryCode": "+507",
  "otp": 123456
}

Advanced Validation with Project Details

{
  "phone": "62647737",
  "countryCode": "+507",
  "otp": 123456,
  "project": "507f1f77bcf86cd799439011",
  "projectFlow": "507f1f77bcf86cd799439015",
  "phoneGateway": "whatsapp"
}

Request

curl -X PUT https://api.verifik.co/v2/phone-validations \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "phone": "62647737",
    "countryCode": "+507",
    "otp": 123456
  }'

Response

The response will contain information about the validated phone validation, including the updated status and any additional data based on the validation type. For onboarding flows, this typically includes basic validation information.

{
  "data": {
    "_id": "674de8df21c72be3cc42b8a7",
    "status": "validated",
    "countryCode": "+507",
    "phone": "62647737",
    "type": "onboarding",
    "showFaceLivenessRecommendation": false
  }
}

Notes

  • Onboarding Flow: This endpoint is specifically designed for users in the app registration process, where phone validation is part of the onboarding journey.

  • OTP Expiration: OTPs have a limited lifespan (typically 10 minutes) and will expire after the predefined time. Expired OTPs cannot be validated.

  • Status Updates: Successful validation automatically updates the phone validation status to "validated" and may trigger additional onboarding steps.

  • Webhook Events: Validation events trigger webhook notifications for tracking and integration purposes.

  • Face Liveness: Some project flows may recommend face liveness verification after phone validation as part of the onboarding process.

  • App Registration Linking: When validated through this endpoint, the phone validation is automatically linked to the user's app registration record.

Onboarding Flow Integration

This validation endpoint is part of the larger onboarding flow where:

  1. User creates an app registration

  2. Phone validation is initiated

  3. OTP is sent to the user's phone

  4. User validates the OTP using this endpoint

  5. Phone validation status is updated

  6. User can proceed to the next step in the onboarding process

The validation ensures that users have access to the phone number they provided during registration, adding an extra layer of security to the onboarding process.

Last updated

Was this helpful?