Getting started with SMS Verification Service

更新时间:
复制 MD 格式

This topic describes the basics, billing methods, workflow, and integration guide for SMS Verification Service to help you get started quickly.

Overview

SMS Verification Service is a verification service provided by Alibaba Cloud for both individual and enterprise users. You can use the API directly without applying for business qualifications, signatures, or templates, making it ideal for individual users who need verification codes but cannot provide enterprise qualifications. The service uses platform-provided resources, ensuring low integration costs and high success rates.

Billing

SMS Verification Service offers two billing methods: subscription package and pay-as-you-go. The service first deducts from your subscription package. If you do not have an active subscription package, you are automatically billed on a pay-as-you-go basis.

Billing method

Description

Subscription package

If you have an active subscription package, usage is first deducted from the package. Any usage beyond the package quota is billed on a pay-as-you-go basis and charged to your account balance.

Purchase SMS Authentication Package

Pay-as-you-go

If you do not have an active subscription package, you are billed in real time with tiered pricing based on the number of messages sent and the message template type. You are not charged for failed verification code deliveries.

Workflow

SMS Verification Service provides multiple optional signatures and SMS templates. Each template contains two variables: a verification code and a validity period. To send a message, you call the API and specify a signature, a template, a verification code, and a validity period. You can configure the service to automatically generate a verification code according to specified rules, or you can provide a custom one.

image

The following section describes the end-to-end workflow. Because no business qualifications, signatures, or templates are required, you can start using the service on the same day you integrate the API.

Step

Description

Actions

Preparation

  • Register an Alibaba Cloud account and complete real-name verification.

  • Activate the service: In the console, enable the SMS Verification Service and converged authentication features.

  • Integration is API-only. You must also create an AccessKey to make API calls.

Console: Enable Phone Number Verification Service

Send verification code

Send a verification code: Call the API to send a verification code SMS message by specifying the destination mobile number, a signature, a template, and values for the variables in the template.

Note

This API can be called from all platforms, including apps, H5 pages, and web applications.

API: SendSmsVerifyCode

(Callable from all platforms)

Query sending results (Optional): Receive delivery reports to confirm that the recipient received the message.

Console: Enable delivery report reception

Delivery report: DypnsSmsVerifyReport (HTTP push mode | message queue mode)

Check verification code

Check the verification code: Call the API to validate the verification code by checking if it matches the phone number and is still within its validity period.

API: CheckSmsVerifyCode

View statistics

View usage statistics, such as the number of codes sent, successful verifications, success rates, and average verification time within a specified period.

Console: SMS Authentication Service Usage Statistics

Quick test

You can use the SMS Verification Service console to add a test mobile number and call the API for a quick test. This lets you try the service's features without needing to apply for qualifications, signatures, or templates.

Send test message
Note

Sending test messages incurs charges. Before you start testing, ensure that your account has a sufficient balance.

On the Quick Test page, in the Test Phone Numbers section, click Add Test Mobile Number to add numbers. You can add up to five test phone numbers per account. After adding the numbers, go to the Live Test section at the bottom of the page and click Call API to Test SMS Authentication Service to begin testing.