Methods
| Method | Description |
|---|---|
CreateSubscription | Create a subscription — by number (SMS_PIN), paid by card / SBP (CustomerType=Card) or via WAP (ClientIP) |
ApproveSubscription | Confirm a subscription with a PIN (1234, three attempts) |
CancelSubscription | Cancel a subscription |
GetSubscriptionStatus | Get subscription status |
ResendPinCode | Resend the PIN — no more than three times, SMS_PIN only |
GetSubscriptions | List the project subscriptions — active and closed, newest first |
RefundBillingOperation | Refund a charge by the BillingOperationID from the notification |
All methods except CreateSubscription, GetSubscriptions and RefundBillingOperation additionally accept <SubscriptionID> — or <Subscriber_MSISDN> / <SubscriberID> instead of it — and ApproveSubscription also takes <PinCode>.
GetSubscriptions is the only method of the service whose path carries no .aspx — that is how the platform specification declares it.
How the sandbox differs for these two. GetSubscriptions returns at most 50 records (the sandbox project is shared), and prints only the fields the sandbox actually keeps: MerchantSubsID, RenewPeriod, ActualRenewCount, ClosedTime and NetworkID are not stored. Billing operations have no state: the BillingOperationID is born in the notification itself and is stored nowhere, so RefundBillingOperation only checks the shape of the identifier (a UUID), treats the refund as instant and always successful, and changes neither the subscription status nor the charge schedule.
Customer fields in CreateSubscription
| Field | When to send it |
|---|---|
Subscriber_MSISDN | SMS_PIN activation. The mock also accepts the legacy name MSISDN, but the spec calls the field Subscriber_MSISDN |
CustomerType = Card | Payment by bank card or SBP. No MSISDN needed |
CustomerId | Customer identifier in your system, required together with CustomerType=Card |
ClientIP | WAP activation when sent without a number. Together with a number — the country match check |
POST /Http/Services/{Method}.aspx
<?xml version="1.0" encoding="utf-8"?>
<Request>
<SubscriptionProjectID>2001</SubscriptionProjectID>
<Subscriber_MSISDN>79001234567</Subscriber_MSISDN>
<Now>20260625120000</Now>
<Signature>d2f36558ca5455be...</Signature>
</Request><Response>
<StatusName>REQUEST_ACCEPTED</StatusName>
<SubscriptionID>10000001</SubscriptionID>
<SubscriberAcceptanceRequired>true</SubscriberAcceptanceRequired>
<SubscriberAcceptanceChannel>SMS_PIN</SubscriberAcceptanceChannel>
<OperatorID>22</OperatorID>
<PaidUntil>2026-07-25T12:00:00+03:00</PaidUntil>
</Response>