Telefonic verification by OTP

Description

Endpoint sending single-use passwords (OTP) using SMS and WhatsApp to check phone numbers as part of processes KYC.

Authentication

Bearer Token with API Kys format sk_live_ or sk_test_ followed by 40 alphanumeric characters.

good practice:

Store in environment variables
Never put them in front code
Rotate every 90 days

Endpoint

POST /api/v1/kyc/phone/send-otp

URL: https://api.jaak.mx

Parameters

Leaders

Leader	Value	Required
`Content-Type`	application / json	Yes
`Authorization`	Bearer + API Key	Yes

Body

Field	Type	Required	Description
`company_id`	string	Yes	Company unique identifier
`country_document`	string	Yes	Code ISO (MEX, COL, ARG, CHL, PER, BRA)
`phone_number`	string	Yes	International format with prefix +

Telephone format: Include national code with symbol + No spaces and no scripts. Example: "+525512345678"

Response Codes

Code	Description
200	Success - Retort `session_id`
400	Invalid / incomplete data or wrong phone format
401	API Invalid or missing key
403	API key without necessary permits
404	`company_id` Unfound
429	Rate limit - 5 applications / 10 min by phone, 100 / hour per company
500	Server error

Example cURL

curl -X POST "https://api.jaak.mx/api/v1/kyc/phone/send-otp" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer <TU_ACCESS_TOKEN>" \
  -d '{
    "company_id": "5f8d0d55b54764421b7156c5",
    "country_document": "MEX",
    "phone_number": "+525512345678"
  }'

Integration Flow

User enters phone number
Valid format application
Call /send-otp with Bearer Token
JAAK send OTP through SMS and WhatsApp
User gets 6-digit code (valid 5 minutes)
User enters code into application
Application verifies code using session_id
Verification completed

Security details of OTP

Numeric code of 6 digits
Valid by 5 minutes
From a only use
Maximum 5 validation attempts by session_id
The session_id expires after validation or 10 minutes

Test environment

Sandbox URL: https://api-sandbox.jaak.mx
Test phone: +525500000001 (always successful)