# Основы

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

API использует протокол HTTPS (запросы с HTTP будут отклоняться), а значит, подходит для разработки на любом языке программирования, который умеет работать с HTTPS-библиотеками.

API работает с POST и GET-запросами. POST-запросы принимают аргументы в JSON, GET-запросы работают со строками запросов. Ответ всегда будет в JSON, независимо от типа запроса.

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

Diagram

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