Тарифная сетка

Широкое мировое покрытие всегда было отличительной чертой проекта SmsCoin. Список стран, в которых доступны услуги наших партнеров, включает 70 государств, а список тарифов, с которыми приходится оперировать нам и нашим партнерам, насчитывает более пятисот. При этом мы постоянно работаем над подключением новых государств, а также увеличением разнообразия тарифов и улучшением условий работы в уже подключенных странах. Самостоятельно проследить за новостями об изменениях, происходящих в нашей системе, и вовремя внести необходимые поправки в инструкции на сайтах вручную практически невозможно.

В связи с этим, мы считаем необходимым автоматизировать генерацию инструкций об оплате на ваших сайтах. Эта проблема не касается тех пользователей, которые используют предлагаемые нами стандартные решения и пользовательские интерфейсы. Для тех же из вас, кто использует свои собственные интерфейсы платежных страниц, мы разработали удобное решение для автоматизации работы с тарифами.

Для каждой из подключенных вами услуг на нашем сервере хранится отдельная тарифная сетка, которая всегда поддерживается в актуальном состоянии в соответствии с индивидуальными настройками панели управления вашим аккаунтом и действующими в нашей системе тарифами. Сетка доступна в стандартных форматах хранения данных — XML и JSON, с которыми можно работать встроенными средствами практически любого языка, используемого при построении сайтов.

Именно на основании данных, содержащихся в индивидуальной тарифной сетке, должны генерироваться любые платежные инструкции на ваших сайтах. Рекомендуем хранить сетку на вашем сервере, автоматически обновляя ее раз в час. Только так можно гарантировать, что пользователям ваших сайтов всегда будет доступна корректная и актуальная инструкция для отправки смс-сообщений. Кроме того, снизив количество запросов к нашему серверу, вы увеличите скорость работы вашего сайта.

Посмотреть примеры различной реализации вывода инструкции можно здесь.

Параметры, передаваемые в тарифной сетке

Тарифная сетка для услуги смс:ключ

Структура:

На структуру тарифной сетки влияют 2 параметра в настройках услуги - список подключённых стран и стоимость смс-сообщения.

Для каждой страны из списка действующих в ней тарифов автоматически подбирается ближайший (в сторону увеличения) к установленной вами стоимости тариф. Те страны, операторы которых не поддерживают установленную вами стоимость, исключаются из списка.

Пример тарифной сетки:

В формате XML: http://service.smscoin.com/xml2/key/200001/

В формате JSON: http://service.smscoin.com/json/key/200001/

где 200001 — ID услуги смс:ключ, замените на ID вашей услуги смс:ключ.

Пример обработки тарифной сетки для вывода пользователю инструкции по отправке смс:

Для чего используется? — Если требуется интеграция смс оплаты в дизайн вашего сайта, и наше стандартное решение не подходит.

В формате XML: Скачать

В формате JSON: Скачать

Тарифная сетка для услуги смс:банк

Структура:

На структуру тарифной сетки влияет только список стран, подключённых в настройках услуги.

Для каждой подключенной страны автоматически выбираются все действующие в ней тарифы.

Пример тарифной сетки:

В формате XML : http://service.smscoin.com/xml2/bank/2/

В формате JSON: http://service.smscoin.com/json/bank/2/

где 2 — ID услуги смс:банк, замените на ID вашей услуги смс:банк.

Пример обработки тарифной сетки для генерации формы инициирования транзакции:

Для чего используется? — Дать пользователю возможность выбрать желаемую сумму для оплаты (выбор страны, оператора и суммы транзакции).

В формате XML: Скачать

В формате JSON: Скачать

Тарифная сетка для услуги смс:транзит

Структура:

На структуру тарифной сетки влияет только список стран, подключённых в настройках услуги.

Скрипт автоматически выбирает все существующие у сотовых операторов тарифы в зависимости от выбранных стран.

Пример тарифной сетки (Статическая тарификация):

Скрипт автоматически подбирает существующие у сотовых операторов тарифы в зависимости от стоимости смс указанной в настройках. Округление осуществляется вверх к ближайшему существующему тарифу. Страны, операторы которых не поддерживают указанную стоимость - исключаются из списка стран.

В формате XML: http://service.smscoin.com/xml2/transit/10000/

В формате JSON: http://service.smscoin.com/json/transit/10000/

Пример тарифной сетки (Динамическая тарификация):

Если вы хотите получить все тарифы выше определённой суммы, укажите ее в поле стоимость и к адресу запроса тарифной сетки добавьте /all .

Скрипт автоматически подбирает все существующие тарифы равные или большие по стоимости относительно смс, указанной в настройках смс:транзита. Страны, операторы которых не поддерживают указанную стоимость, исключаются из списка стран.

Для того, чтобы получить весь список тарифов в нашей системе по выбранным странам, укажите стоимость услуги — 0.

В формате XML: http://service.smscoin.com/xml2/transit/10000/all

В формате JSON: http://service.smscoin.com/json/transit/10000/all

где 10000 — ID услуги смс:транзит, замените на ID вашей услуги смс:транзит.

Пример обработки тарифной сетки для вывода пользователю инструкции по отправке смс:

Для чего используется? — Вывод пользователю инструкции по отправке смс (выбор страны, оператора и суммы транзакции).

В формате XML: Скачать

В формате JSON: Скачать

Часто задаваемые вопросы

К моей услуге привязан персональный префикс, будет ли он выводится в инструкции по отправке смс для моих клиентов?

Если инструкция по отправке смс генерируется по тарифной сетке для данной услуги, то во всех тарифах, где поддерживается префикс, замена произойдёт автоматически, иначе будет выведен стандартный формат смс сообщения.

Как часто нужно обновлять локальную копию моей тарифной сетки?

Рекомендуется обновлять локальную копию раз в час. При таких настройках вы не нагружате ваш сервер, а ваши пользователи получают корректную инструкцию быстрее, чем при постоянных запросах к нашему серверу.

Что произойдёт, если ваш сервер окажется недоступен?

В случае, если вы работаете с локальной копией вашей тарифной сетки — вы будете продолжаете работать по ней, при обновлении она не изменится.

Как получить названия стран и операторов в инструкции на другом языке?

Тарифная сетка доступна и на других языках.
К пример, на английском: http://service.smscoin.com/language/english/xml/transit/10000/
Для выбора другого языка укажите его в строке запроса вместо english.