Subscription flow (SMS_PIN)
CreateSubscription— create a subscription for the number. The response containsSubscriptionID,SubscriberAcceptanceChannel=SMS_PINand statusPending.ApproveSubscription— confirm the subscription with PIN1234. A wrong code returnsWRONG_PARAMS/InvalidPinCodewith the attempts left; after the third one the subscription moves toApprovingFailedand the correct PIN no longer helps.- The subscription becomes
Active, and 15 seconds later aSubscriptionStatusNotificationcallback withEventType=APPROVEDis sent. GetSubscriptionStatus— check the status (SubscriptionStatus=Active);CancelSubscription— cancel: the status becomesCancelledand anEventType=CANCELLEDcallback arrives.
ApproveSubscription — request
<Request>
<SubscriptionProjectID>2001</SubscriptionProjectID>
<SubscriptionID>10000001</SubscriptionID>
<PinCode>1234</PinCode>
<Now>20260625120000</Now>
<Signature>d2f36558ca5455be...</Signature>
</Request>Wrong PIN
<Response>
<StatusName>WRONG_PARAMS</StatusName>
<ErrorReasonName>InvalidPinCode</ErrorReasonName>
<ErrorDescription>Invalid PIN code, 2 attempt(s) left</ErrorDescription>
</Response>