List of available statuses

(this is for set_activation_status -method)

cancel - cancel current activation, money subtracted from your balance are going to be instantly returned to your balance.

sms_sent - service has confirmed, that SMS was sent to phone number from current activation.

one_more_code - the service is going to send another confirmation code to same phone number (usable only after 1st phone code was received).

end - you are ready with current phone number and you don't need it anymore (only usable after at least 1 code was received).

already_used - marks this phone number as already used one (happens rarely due to carriers-mistake), ends current activation, money subtracted from your balance are going to be instantly returned to your balance.

Some basic examples and cases:

1. Buy a number with buy_number -method.
2. Try to register an account for a chosen service using phone number from current activation.

Possible situations:

a) Number was never used in this service before >> GOTO 3.

b) Number was already used and You don't want (can't) to reuse it >>

2(.b.1) Set a new activation status with set_activation_status -method to already_used.

2(.b.2) Then GOTO 1. and retry .

3. Set activation status to sms_sent with set_activation_status -method.

4. Use get_activation_status -method once in every 20 seconds to get updates on current activation.

Possible situations:

a) You receive code from get_activation_status -method in a few minutes (usually 10-40 seconds) after changing status to sms_sent >> GOTO 5.

b) You didn't receive code after 10 minutes from changing status to sms_sent. >>

4(.b.1) Set a new activation status with set_activation_status -method to cancel.

4(.b.2) Then GOTO 1. and retry .

5. After confirming phone number on new account with received SMS-code You can:

a) End current activation via setting status of current activation to end with set_activation_status -method

or

b) Receive another SMS-code to the same phone number from the same service. This feature could be used in some services, that allow registering multiple accounts with same phone number (Yandex a.e.). You won't be charged for following SMS-codes - You pay only once. After receiving codes proceed to 5.a and end activation.