Send Link
This API returns a link to be sent via SMS to the consumer that serves as a verification mechanism. The generated link is sent to the mobile number provided by the customer via an SMS. The consumer then clicks on the link to begin the authentication & gets redirected to the target URL provided.
Start the process by capturing the phone number from the consumer so you can generate the one-time, fortified link for that specific number. This is generally done via a web form or otherwise obtained via your consumer records. Please find an example of end user form below.
After obtaining the phone number, your web server should then initiate a request to the Send Instant Link API endpoint. As part of the request, the MobileNumber and a TargetUrl should be included. The TargetUrl is the destination the end user should be delivered to after they click on the link, where we redirect the web session upon completion of network authentication. It can be any custom URL that fits your preferred user experience; it simply needs to be able to capture the returned VFP.
The fortified link will be sent via SMS to the consumer into an SMS body as visible in the screenshot below.
Messaging here is key; you should highlight several things in your SMS message:
- Identify the business in the message (i.e., “Here is your {business name} authentication link.”).
- Warn the consumer that they should only click on the link if they are expecting it
- We can also recommend to customer to disconnet Wi-Fi before cliking for better results
You must first log in before sending the request. The authorization header in the request must include the access token obtained from the login API call.
Need to pass the following information. Providing targetUrl, mobileNumber and countryCode(only valid values 'US' or 'CA') is mandatory. sourceIp is optional and can be used as an additional fraudulent detection indicator.
- targetUrl(required)
- mobileNumber(required)
- sourceIp(optional)
- customSms(optional)
- countryCode(required)
Parameter | Data Type | Required | Description |
|---|---|---|---|
targetUrl | string | Yes | Required The URL of the client server that will be called back by the phone, providing the VFP for the result call |
mobileNumber | string | Yes | Required The phone number being queried. (without leading plus sign & country code) |
countryCode | string | Yes | Required The country code associated. Only valid values allowed are 'US' or 'CA'. |
Key | Type | Description |
|---|---|---|
requestId | string | The unique identifier for the request. |
sessionId | string | The session ID associated with the request. |
Parameter | Description |
|---|---|
error | This parameter contains the error. |
error.name | the error name. |
error.message | the error message. |
error.status | Status of the api |
error.reason | Reason for error |
error.type | Type of the error |
error.statusCode | Request Status code from Signzy |
Getting help
Please feel free to contact us if you have any questions, require clarification, or have ideas for how to make the documents or any of our services better.
You can reach out to us at [email protected]. We strive to provide prompt and reliable assistance, ensuring your queries are addressed effectively.
We value your feedback and are committed to making your experience smooth and enjoyable. Our team is dedicated to assisting you with any needs you may have. Thank you for choosing our services. We look forward to helping you!