Messente avatar logo

Number verification widget

Number Verification Widget

Verification Widget API endpoint
API endpointhttps://verify.messente.com/
Request parameters
KeyValueRequired
userYour Messente API username Yes
versionVersion of the API used - currently fixed to "1" Yes
callback_urlURL where user is redirected back Yes
phoneOptional parameter which pre-fills the user phone number in the widget No
sigCalculated MD5 hash with secure password. See "Secure Signature Calculation" for more details. Yes

Secure Signature ("sig") Calculation

"sig" is a secure MD5 hash calculated using your Messente API password as a secret ("pass" parameter).

Signature is composed by concatenating all the verification widget HTTP POST keys and parameters (no spaces in between), ordered alphabetically by keys.

Example "sig" calculation
user = 039u230pifj23pg9ih23pgi23
pass = iejfp23oigh230p9gh32pgh2
version = 1
callback_url = http://mydemo.com/verification/

sig = md5(callback_urlhttp://mydemo.com/verification/passiejfp23oigh230p9gh32pgh2user039u230pifj23pg9ih23pgi23version1)
// sig = 75024ad39fc4cee828cd103b88b3df4
Response parameters
KeyValue
userYour Messente API username used in the request
versionVersion of the API used - currently fixed to "1"
statusVerification status VERIFIED | CANCELLED
phonePhone number which was used for verification
sigCalculated MD5 hash with secure password. See "Secure Signature Calculation" for more details.

Verifying returned request

If the user is redirected back to the main website, the Secure Signature ("sig") has to be verified again by using your Messente API password ("pass") to avoid spoofing successful verification.

Ready-made libraries and examples

Live Demo

Click the button to check out phone number verification widget: