Introduction
Mobile phone number serves as the ultimate user identity in digital universe. Digital applications whether on web or on mobile verify mobile numbers of their users to ensure their authenticity. To address this growing need, Message Central has developed a reliable, quick and cost-effective mobile number verification service called Verify Now.
Help and Support
For implementation support and any feedback, please reach out to us at: operations@messagecentral.com
API Request and Response
The API will only accept requests from the service provider via the API Endpoint URI shared with the service provider and from whitelisted IP addresses over HTTP, partner to provide a list of source IP.
REST API Base URL’s:
All Platform API endpoints below should beprefixed with the following URL:
https://api-prod.messagecentral.com
A. Send OTP
To send otp on mobile number below are request parameters.
Request URL Path:
/messageCentral/v1.0/sendOtp
Response JSON:
A successful response will return a 200 status code.
{
"responseCode": Integer,
"message": "String",
"data": {
"verificationId": "String",
"mobileNumber": "String",
"responseCode": "String",
"errorMessage": "String",
"timeout": "String",
"smsCLI": "String",
"transactionId": "String"
}
}
Below is an example success send otp:
curl --location--request POST 'https://api-prod.messagecentral.com/messageCentral/v1.0/sendOtp?countryCode=91&customerId=****************&flowType=SMS&mobileNumber=9716812823'\--header 'authToken: ****************'
{
"responseCode": 200,
"message": "SUCCESS",
"data": {
"verificationId": "20",
"mobileNumber": "8846735392",
"responseCode": "200",
"errorMessage": null,
"timeout": "60",
"smsCLI": null,
"transactionId": null
}
}
B. Validate OTP
To validate below are fields.
For now we support English only
Request URL Path:
/messageCentral/v1.0/validateOtp
Response JSON:
A successful response will return a 200 status code.
{
"responseCode": Integer,
"message": "String",
"data": {
"verificationId": Long,
"mobileNumber": "String"
"verificationStatus": "String",
"responseCode": "String",
"errorMessage": "String",
"transactionId": "String",
"authToken": "String"
}
}
Below is an example of successful validation
curl --location 'https://api-prod.messagecentral.com/messageCentral/v1.0/validateOtp?countryCode=XX&mobileNumber=*********&verificationId=XX&customerId=************&code=XXXX'\
--header 'authToken: *************************'
{
"responseCode": 200,
"message": "SUCCESS",
"data": {
"verificationId": 20,
"mobileNumber": "8846735392",
"verificationStatus": "VERIFICATION_COMPLETED",
"responseCode": "200",
"errorMessage": null,
"transactionId": null,
"authToken": *************************
}
}