# I-Free Money — документация платёжного API

> Документация платёжного API I-Free Money: приём оплаты с баланса телефона (DCB), карты, СБП, SberPay и подписки. REST JSON v3 и XML v2.9, подпись HMAC-SHA256, вебхуки, коды ошибок, песочница. Русская версия — https://i-free.money/developers/ru, английская — https://i-free.money/developers/en. Примеры на curl, PHP и Python, окружения sandbox и prod переключаются вкладками.

## Вся документация одним файлом

- [Полный справочник](https://i-free.money/developers/llms-full.txt): вся документация обоих продуктов одним файлом — оглавление со ссылками на страницы, все методы, примеры, таблицы адресов. Канонический адрес для чтения агентом.
- [Тот же справочник как .md](https://i-free.money/developers/developers.md): то же содержимое с типом text/markdown.

## Разовые платежи

Callisto — DCB, банковские карты, СБП и SberPay. Два протокола: REST JSON v3 и XML v2.9. Песочница: https://i-free.money/developers/ru/sandbox/payments/sb-intro

### Руководство

- [Быстрый старт](https://i-free.money/developers/ru/payments/quickstart)
- [Протокол XML](https://i-free.money/developers/ru/payments/xml-overview)
- [Аутентификация](https://i-free.money/developers/ru/payments/auth)
- [Общие соглашения](https://i-free.money/developers/ru/payments/conventions)
- [Оплата с телефона (DCB)](https://i-free.money/developers/ru/payments/dcb)
- [Карты, СБП, SberPay](https://i-free.money/developers/ru/payments/cards)
- [Общие методы](https://i-free.money/developers/ru/payments/common)
- [Вебхуки](https://i-free.money/developers/ru/payments/callbacks)
- [Коды и справочники](https://i-free.money/developers/ru/payments/errors)
- [Подпись запросов](https://i-free.money/developers/ru/payments/signature)
- [Сводка эндпоинтов](https://i-free.money/developers/ru/payments/endpoints)
- [Виджет оплаты](https://i-free.money/developers/ru/payments/payment-widget)

### Справочник методов JSON + XML

- [Создать инвойс](https://i-free.money/developers/ru/payments/ref/ref-createInvoice)
- [Авторизовать инвойс PIN-кодом](https://i-free.money/developers/ru/payments/ref/ref-authorizeInvoice)
- [Получить инвойс по id](https://i-free.money/developers/ru/payments/ref/ref-getInvoice)
- [Получить инвойс по merchant_order_id](https://i-free.money/developers/ru/payments/ref/ref-getInvoiceByMerchantOrderId)
- [Отменить инвойс](https://i-free.money/developers/ru/payments/ref/ref-cancelInvoice)
- [Возврат по инвойсу](https://i-free.money/developers/ru/payments/ref/ref-refundInvoice)
- [Создать контракт абонента](https://i-free.money/developers/ru/payments/ref/ref-createContract)
- [Авторизовать контракт PIN-кодом](https://i-free.money/developers/ru/payments/ref/ref-authorizeContract)
- [Отменить контракт](https://i-free.money/developers/ru/payments/ref/ref-cancelContract)
- [Проверить поддержку биллинга для абонента](https://i-free.money/developers/ru/payments/ref/ref-checkCustomerBillingSupport)
- [SDK встраивания виджета оплаты](https://i-free.money/developers/ru/payments/ref/ref-sbpWidgetEmbedJs)
- [Страница виджета — содержимое iframe](https://i-free.money/developers/ru/payments/ref/ref-sbpWidgetPage)
- [Данные QR по счёту](https://i-free.money/developers/ru/payments/ref/ref-sbpWidgetCreateQr)
- [Опрос статуса оплаты](https://i-free.money/developers/ru/payments/ref/ref-sbpWidgetStatus)
- [Подтверждение платёжной транзакции](https://i-free.money/developers/ru/payments/ref/ref-xml-confirmPaymentTransaction)
- [Получение доступных способов оплаты для проекта](https://i-free.money/developers/ru/payments/ref/ref-xml-projectCustomerSupport)
- [Отправка контента по счёту](https://i-free.money/developers/ru/payments/ref/ref-xml-sendInvoiceContent)

## Подписки

Subscription Service — подписка по номеру с PIN, картой, СБП или через WAP: подтверждение, статус, отмена, цикл списаний. Отдельный XML-протокол с собственной подписью. Песочница: https://i-free.money/developers/ru/sandbox/subscriptions/sbs-intro

### Руководство

- [Обзор протокола](https://i-free.money/developers/ru/subscriptions/subs-overview)
- [Подпись запросов](https://i-free.money/developers/ru/subscriptions/subs-auth)
- [Методы](https://i-free.money/developers/ru/subscriptions/subs-methods)
- [Коллбек](https://i-free.money/developers/ru/subscriptions/subs-callbacks)
- [Статусы и ошибки](https://i-free.money/developers/ru/subscriptions/subs-statuses)
- [Виджет оплаты](https://i-free.money/developers/ru/subscriptions/subs-payment-widget)

### Справочник методов XML

- [Создать подписку](https://i-free.money/developers/ru/subscriptions/ref/ref-createSubscription)
- [Отменить подписку](https://i-free.money/developers/ru/subscriptions/ref/ref-cancelSubscription)
- [Подтвердить подписку (PIN)](https://i-free.money/developers/ru/subscriptions/ref/ref-approveSubscription)
- [Повторно отправить PIN](https://i-free.money/developers/ru/subscriptions/ref/ref-resendPinCode)
- [Получить статус подписки](https://i-free.money/developers/ru/subscriptions/ref/ref-getSubscriptionStatus)
- [Список подписок проекта](https://i-free.money/developers/ru/subscriptions/ref/ref-getSubscriptions)
- [Возврат платежа по подписке](https://i-free.money/developers/ru/subscriptions/ref/ref-refundBillingOperation)
- [SDK встраивания виджета оплаты подписок](https://i-free.money/developers/ru/subscriptions/ref/ref-sbpWidgetEmbedJs)
- [Страница виджета — содержимое iframe](https://i-free.money/developers/ru/subscriptions/ref/ref-sbpWidgetPage)
- [Начальный шаг выбранным способом](https://i-free.money/developers/ru/subscriptions/ref/ref-sbpWidgetCreateQr)
- [Опрос статуса начального шага](https://i-free.money/developers/ru/subscriptions/ref/ref-sbpWidgetStatus)
- [SubscriptionStatusNotification (Provider → Merchant)](https://i-free.money/developers/ru/subscriptions/ref/ref-subscriptionStatusNotification)

## Песочница

Тестовая среда разовых платежей и подписок: полный цикл интеграции без выхода в боевой контур — реальных платежей и списаний не происходит. Внутри — тестовые доступы и данные, быстрый старт, сценарии оплаты с баланса телефона, картой и СБП, возвраты и рекурренты, эмуляция ошибок и коллбеков, справочники кодов, отличия от боевой среды и готовые клиенты.

### Разовые платежи

- [Введение](https://i-free.money/developers/ru/sandbox/payments/sb-intro)
- [Быстрый старт](https://i-free.money/developers/ru/sandbox/payments/sb-quickstart)
- [Доступ и тестовые данные](https://i-free.money/developers/ru/sandbox/payments/sb-access)
- [Sandbox ↔ Production](https://i-free.money/developers/ru/sandbox/payments/sb-vs-prod)
- [Подпись запросов](https://i-free.money/developers/ru/sandbox/payments/sb-auth)
- [Сценарий: MSISDN](https://i-free.money/developers/ru/sandbox/payments/sb-flow-msisdn)
- [Сценарий: карта](https://i-free.money/developers/ru/sandbox/payments/sb-flow-card)
- [Сценарий: СБП](https://i-free.money/developers/ru/sandbox/payments/sb-flow-sbp)
- [Сценарий: возврат](https://i-free.money/developers/ru/sandbox/payments/sb-flow-refund)
- [Сценарий: рекуррент](https://i-free.money/developers/ru/sandbox/payments/sb-flow-recurring)
- [Сценарий: привязка карты](https://i-free.money/developers/ru/sandbox/payments/sb-flow-card-binding)
- [Сценарий: 3-D Secure](https://i-free.money/developers/ru/sandbox/payments/sb-flow-3ds)
- [Виджет оплаты](https://i-free.money/developers/ru/sandbox/payments/sb-payment-widget)
- [Структура запросов](https://i-free.money/developers/ru/sandbox/payments/sb-api-structure)
- [Создание контракта](https://i-free.money/developers/ru/sandbox/payments/sb-m-create-contract)
- [Авторизация контракта](https://i-free.money/developers/ru/sandbox/payments/sb-m-authorize-contract)
- [Отмена контракта](https://i-free.money/developers/ru/sandbox/payments/sb-m-cancel-contract)
- [Создание инвойса](https://i-free.money/developers/ru/sandbox/payments/sb-m-create-invoice)
- [Статус инвойса](https://i-free.money/developers/ru/sandbox/payments/sb-m-get-invoice)
- [Отмена инвойса](https://i-free.money/developers/ru/sandbox/payments/sb-m-cancel-invoice)
- [Возврат средств](https://i-free.money/developers/ru/sandbox/payments/sb-m-refund-invoice)
- [Проверка биллинга](https://i-free.money/developers/ru/sandbox/payments/sb-m-billing-check)
- [Коллбеки](https://i-free.money/developers/ru/sandbox/payments/sb-callbacks)
- [Ошибки JSON v3 (HTTP)](https://i-free.money/developers/ru/sandbox/payments/sb-errors-http)
- [Коды ResultCode](https://i-free.money/developers/ru/sandbox/payments/sb-errors-wiremock)
- [Ошибки карты](https://i-free.money/developers/ru/sandbox/payments/sb-errors-card)
- [Песочные ручки (test_info)](https://i-free.money/developers/ru/sandbox/payments/sb-test-info)
- [Типовые ошибки](https://i-free.money/developers/ru/sandbox/payments/sb-pitfalls)
- [Рекомендации](https://i-free.money/developers/ru/sandbox/payments/sb-best-practices)
- [Готовый клиент](https://i-free.money/developers/ru/sandbox/payments/sb-client)
- [MCP-сервер](https://i-free.money/developers/ru/sandbox/payments/sb-mcp)
- [ResultCode](https://i-free.money/developers/ru/sandbox/payments/sb-ref-result)
- [PaymentResultCode](https://i-free.money/developers/ru/sandbox/payments/sb-ref-payment)
- [InvoiceStatus](https://i-free.money/developers/ru/sandbox/payments/sb-ref-invoice-status)
- [PaymentStatus](https://i-free.money/developers/ru/sandbox/payments/sb-ref-payment-status)
- [AuthorizationType](https://i-free.money/developers/ru/sandbox/payments/sb-ref-auth-type)
- [BillingChannel](https://i-free.money/developers/ru/sandbox/payments/sb-ref-billing-ch)
- [Операторы](https://i-free.money/developers/ru/sandbox/payments/sb-ref-operators)

### Подписки

- [Введение](https://i-free.money/developers/ru/sandbox/subscriptions/sbs-intro)
- [Быстрый старт](https://i-free.money/developers/ru/sandbox/subscriptions/sbs-quickstart)
- [Доступ и тестовые данные](https://i-free.money/developers/ru/sandbox/subscriptions/sbs-access)
- [Sandbox ↔ Production](https://i-free.money/developers/ru/sandbox/subscriptions/sbs-vs-prod)
- [Подпись запросов](https://i-free.money/developers/ru/sandbox/subscriptions/sbs-auth)
- [Методы](https://i-free.money/developers/ru/sandbox/subscriptions/sbs-methods)
- [Флоу подписки](https://i-free.money/developers/ru/sandbox/subscriptions/sbs-flow)
- [Подписка картой и СБП](https://i-free.money/developers/ru/sandbox/subscriptions/sbs-flow-card)
- [Активация через WAP](https://i-free.money/developers/ru/sandbox/subscriptions/sbs-flow-wap)
- [Виджет оплаты](https://i-free.money/developers/ru/sandbox/subscriptions/sbs-payment-widget)
- [Хуки песочницы: Списания](https://i-free.money/developers/ru/sandbox/subscriptions/sbs-test-info)
- [Отказы и лимиты](https://i-free.money/developers/ru/sandbox/subscriptions/sbs-errors)
- [Коллбеки](https://i-free.money/developers/ru/sandbox/subscriptions/sbs-callbacks)
- [Типовые ошибки](https://i-free.money/developers/ru/sandbox/subscriptions/sbs-pitfalls)
- [Рекомендации](https://i-free.money/developers/ru/sandbox/subscriptions/sbs-best-practices)
- [Готовый клиент](https://i-free.money/developers/ru/sandbox/subscriptions/sbs-client)
- [MCP-сервер](https://i-free.money/developers/ru/sandbox/subscriptions/sbs-mcp)

## FAQ

Вопросы, которые чаще всего приходят на этапе интеграции и после запуска, — с короткими ответами и ссылками на подробные разделы. Здесь же то, что упирается не в API, а в договор, эквайера или бухгалтерию: такие вопросы обычно зависают между техподдержкой и менеджером.

### Руководство

- [Разовые платежи](https://i-free.money/developers/ru/faq/payments)
- [Подписки](https://i-free.money/developers/ru/faq/subscriptions)
- [Лимиты, чеки, сверки](https://i-free.money/developers/ru/faq/business)

## Машиночитаемые ресурсы

- [llms.txt](https://i-free.money/developers/llms.txt) — Карта документации для ИИ-агентов
- [Справочник в Markdown](https://i-free.money/developers/developers.md) — Вся документация одним .md-файлом
- [OpenAPI — JSON v3](https://i-free.money/developers/openapi/callisto_json_v3.yaml) — Спецификация REST JSON, YAML
- [OpenAPI — XML v2.9](https://i-free.money/developers/openapi/callisto_xml.yaml) — Спецификация XML-протокола, YAML
- [OpenAPI — подписки](https://i-free.money/developers/openapi/subscription_service.yaml) — Спецификация Subscription Service, YAML
- [Postman — разовые платежи](https://i-free.money/developers/openapi/callisto_postman.json) — Коллекция Callisto: подпись считается в pre-request script
- [Postman — подписки](https://i-free.money/developers/openapi/subscription_postman.json) — Коллекция Subscription Service со своей подписью
- [MCP-сервер](https://pay-sandbox.digitalspb.com/mcp) — Живой эндпоинт песочницы для ИИ-агентов, Streamable HTTP без авторизации

Основной сайт: https://i-free.money