Обзор протокола

Платёж

Северное Чертаново, микрорайон 1а 1Mozilla/5.0 (платформа; rv:версия gecko) Gecko/геоко трасса Firefox/версия firefox

Ошибка обмена токенами. Токен отключен, создайте новый

Статусы проверки карты

Платеж токеном СБП

Пример платежа токеном СБП: Цветок для моей девушки

Статус QR-кода СБП

Пример запроса статуса QR-кода СБП

Формат взаимодействия

API Протокола приема платежей основан на принципах REST-архитектуры.
Данные и методы считаются ресурсами, доступными через вызов универсальных идентификаторов ресурсов (URI).

Методы API вызываются через HTTP-запросы. Постоянная часть URL-адреса для вызова методов API.

Параметры методов помещаются в JSON-тело запроса. В GET-запросах параметры помещаются в query запроса.

Необходимо указывать Accept: application/json в заголовках запроса — API всегда возвращает ответ в формате JSON.

Методы API обеспечивают логическую идемпотентность, т.е. многократный вызов метода эквивалентен однократному. Однако ответ сервера может меняться (например, состояние счёта может измениться между запросами).

Получение QR-кода СБП

Пример получения QR-кода СБП (метод POST) Цветок для моей девушки

Метод PUT

Пример получения QR-кода СБП (метод PUT) Цветок для моей девушки

Расходы на ремонт телефона

В процессе эксплуатации телефона может возникнуть необходимость в его ремонте.

Расходы на ремонт телефона, независимо от того, является он основным средством или малоценным оборудованием, признаются расходами периода, в котором они понесены, в размере фактических затрат в силу ст. 260 НК.

Счет учета расходов на ремонт основного средства соответствует тому счету, на который принимаются расходы по его амортизации (в нашем случае счет 26), а расходы на ремонт малоценного оборудования учитываются на счете, на который были списаны расходы на момент принятия его к учету и ввода в эксплуатацию (в нашем случае это также счет 26).

Для учета услуг по ремонту в программе 1С: Бухгалтерия предприятия ред. 3.0 в разделе Покупки — Поступление (акты, накладные, УПД) создаем документ с видом Услуги (акт, УПД):

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

Налоговый учет

В налоговом учете расходы на ремонт основных средств и иного имущества относятся к прочим расходам, связанным с производством и реализацией (пп. 2 п. 1 ст. 253 НК), поэтому в поле вид расхода выбираем Прочие расходы в обоих случаях.

Статусы операций

Статус операции отражает ее текущее состояние.

Ответы API

API возвращает синхронный статус операции в поле status.value.

Уведомления

Платежный токен

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

Серверные уведомления

Уведомление от QIWI — это входящий POST-запрос с информацией о событии. Тело запроса содержит JSON-сериализованные данные платежа/счета (кодировка UTF-8).

Протокол поддерживает следующие типы уведомлений о событиях API. Адрес вашего сервера для обработки уведомлений указывается в Личном кабинете в разделе Настройки.

Чтобы указать URL сервера обработки уведомлений для отдельной операции, используйте параметры. URL для уведомлений должен начинаться с https, так как уведомления отправляются по протоколу HTTPS на порт 443. URL должен быть доступен из Интернета. Сертификат сайта должен быть выпущен доверенным центром сертификации (например Comodo, Verisign, Thawte и т.п.). Уведомление считается успешно доставленным, если ваш сервер ответил HTTP кодом состояния 200 OK.

Оплата телефона с карты Сбербанка через USSD запрос

Моментально пополнить свой баланс абонент может с помощью сервисной команды: *900*800#

Чтобы перевести сумму на другой телефон, используя USSD-запрос, наберите команду:

И нажмите вызов.

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

Защитить свои средства можно, если заранее настроить запрет на пополнение телефонных счетов, которых нет в списке шаблонов. Это поможет предотвратить возможное хищение денег в случае потери телефона или кражи.

Создание счёта

Пример создания счета

Статус подтверждения

Пример запроса статуса подтверждения

Платеж через форму QIWI

При подключении платежей через форму QIWI покупателю доступен только способ оплаты банковскими картами. Другие способы оплаты включаются по запросу:

Чтобы выполнить платеж через форму QIWI, выставите счет покупателю. Воспользуйтесь выставлением счета через API или перенаправьте покупателя на форму QIWI по прямой ссылке с параметрами счета.

Процесс платежа

Yandex Pay

Оплата покупок с Yandex Pay происходит без ввода данных карты.

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

Как отправлять платеж

Пример платежа с данными расшифрованного платежного токена Yandex Pay (метод CLOUD_TOKEN)

Пример платежа с данными расшифрованного платежного токена Yandex Pay (метод PAN_ONLY)

Формат платежных данных зависит от способа аутентификации, указанного в поле authMethod расшифрованного платежного токена Yandex Pay:

ChequeData

Информация о фискальном чеке по операции.

Возвраты по сплитованным платежам

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

Пример запроса с возвратами по сплитованному платежу

Товар из корзины

В запросе API Операция возврата передайте JSON-массив refundSplits с данными о возвратах. Укажите общую сумму возврата и сумму возврата для каждого сплита.

Формат массива refundSplits в запросе:

В JSON-массиве refundSplits ответа содержатся данные о принятых возвратах:

Выплаты

Для тестирования различных вариантов выплаты и ответов в тестовом режиме указывайте разные суммы платежа (поле amount.value):
| Значение поля amount.value | Результат |
| -------------------------- | ------------------------------------------- |
| 200.00 или 2.00 | На инициирующий запрос выплаты возвращается status.value=WAITING, на последующие запросы статуса выплаты возвращается status.value=SUCCESS |
| 500.00 или 5.00 | На запрос выплаты возвращается status.value=DECLINED |
| 510.00 или 5.10 | На инициирующий запрос выплаты возвращается status.value=WAITING, на последующие запросы статуса выплаты возвращается status.value=DECLINED |
## Возвраты по проведенным платежам
Возврат по платежу возможен только для успешно проведенного платежа. Возврат может быть как частичным, так и полным. В первом случае возвращается вся сумма принятого платежа. Во втором — только часть от суммы платежа. Перед возвратом платежа проверьте, что платеж успешно завершен и находится в статусе COMPLETED.
Чтобы выполнить возврат по карточному платежу, используйте метод API Операция возврата.
## Как использовать сервис через API
Пример запроса проверки карты
Пример тела успешного ответа
Пример тела ответа с проверкой 3DS
Some string pareq
Пример тела ответа с ошибкой проверки
Пример запроса завершения 3DS при проверке карты
Some string pares
Чтобы убедиться, что номер карты ввел именно держатель карты, можно использовать дополнительную аутентификацию покупателя 3-D Secure. Включение/отключение 3DS производится на стороне QIWI через Службу поддержки. Если 3DS включен, то в ответе на запрос проверки карты вы получите объект requirements с ACS URL для перенаправления покупателя (в поле status будет значение WAITING_3DS).
Сценарий дополнительной аутентификации аналогичен операции покупки:
После завершения проверки вам придет уведомление CHECK_CARD с результатом. Также вы можете всегда запросить текущий статус проверки.
## Частота отправки уведомлений
Сервис отправки уведомлений распределяет неуспешные уведомления по очередям:
Время повторной отправки может быть увеличено.
Использование платежного токена в запросе платежа
Платежные токены используются для списаний с карт или QIWI кошельков без ввода реквизитов карты или номера кошелька. Метод оплаты платежным токеном по умолчанию отключен. Чтобы подключить его, обратитесь к вашему сопровождающему менеджеру.
При оплате платежным токеном покупатель не будет указывать свои карточные данные и проходить проверку 3-D Secure.
О выпуске платежного токена см. подробнее в этом разделе.
Чтобы инициировать платёж с оплатой платежным токеном, передайте в запросе API Платеж:
Если карта, для которой выпущен платежный токен, была уже ранее сохранена (токенизирована) на вашей стороне, должны быть добавлены дополнительные параметры в объекте paymentMethod:
## Ситуация № 2. Телефон приобретен в розничном магазине, из документов у вас лишь кассовый чек
Для примера возьмем те же самые телефоны, которые были у нас в предыдущем примере: телефон стоимостью 60 000 рублей (малоценное оборудование) и телефон стоимостью 120 000 рублей (основное средство).

Проводим от сотрудника авансовый отчет. Так как у нас нет от поставщика счета-фактуры, галочку в соответствующем поле мы не ставим:

После проведения авансового отчета приобретенный телефон будет оприходован на счет учета малоценного оборудования 10.21 (так как в карточке номенклатуры при создании мы выбрали вид номенклатуры «Малоценное оборудование и запасы»), сумма НДС с 19 счета спишется в расходы (в бухгалтерском учете) на счет 91.02 на статью прочих доходов и расходов «Списание НДС, не подтвержденного счетом-фактурой поставщика»; к налоговому учету НДС, не подтвержденный счетом-фактурой, не принимается:

Далее, как и в предыдущем примере, мы передаем наш телефон сотруднику с помощью документа «Расход материалов (требования-накладные)», после чего счет 10.21 закрывается, а телефон попадает на забалансовый счет МЦ.04.

При поступлении по авансовому отчету телефона стоимостью 120 000 рублей, то есть того, который согласно положениям нашей учетной политики, относится к основным средствам, все проводки будут те же, кроме счета поступления. Это будет счет 08.04.1, так как в карточке номенклатуры для данного телефона нами выбран ранее вид номенклатуры «Оборудование (объекты основных средств)»:

После принятия телефона к учету по авансовому отчету оформляем документ «Принятие к учету ОС». Теперь телефон числится на балансе организации в качестве основного средства:

Формат уведомления PAYOUT

Пример тела уведомления PAYOUT

Поле Описание Тип В каких случаях используется

payout Описание выплаты Object Всегда

payout.payoutId Идентификатор выплаты в системе ТСП String(200) Всегда

payout.createdDateTime Дата создания операции URL-закодированная строкаГГГГ-ММ-ДДTчч:мм:ссZ Всегда

payout.amount Информация о сумме операции Object Всегда

payout.amount.value Сумма операции, округленная до двух десятичных знаков в меньшую сторону Number(6.2) Всегда

payout.amount.currency Идентификатор валюты операции (Alpha-3 ISO 4217 код) String(3) Всегда

payout.status Информация о статусе операции Object Всегда

payout.status.value Строковое значение статуса String Всегда

payout.status.changedDateTime Дата обновления статуса URL-закодированная строкаГГГГ-ММ-ДДTчч:мм:ссZ Всегда

payout.status.reasonCode Код причины отклонения String(200) В случае отклонения операции

payout.status.reasonMessage Описание причины отклонения String(200) В случае отклонения операции

payout.status.errorCode Код ошибки Number В случае ошибки

payout.receiverData Информация о получателе PayoutReceiverDataCallback Всегда

payout.merchantSiteUid Строковый идентификатор сайта ТСП в QIWI Кассе String Всегда

payout.flags Дополнительные флаги операции Array(Strings). Возможные элементы: TEST При необходимости

payout.payoutSplits Описание сплитованных выплат Array(Objects) Всегда

payout.payoutSplits.type Тип передаваемых данных. Всегда строка MERCHANT_DETAILS String Всегда

payout.payoutSplits.siteUid ID поставщика String Всегда

payout.payoutSplits.splitAmount Информация о списании с поставщика Object Всегда

payout.payoutSplits.splitAmount.value Сумма списания Number Всегда

payout.payoutSplits.splitAmount.currency Буквенный код валюты списания по ISO String(3) Всегда

payout.payoutSplits.splitCommissions Информация о комиссии Object При необходимости

payout.payoutSplits.splitCommissions.merchantCms Информация о комиссии с поставщика Object При необходимости

payout.payoutSplits.splitCommissions.merchantCms.value Сумма комиссии Number При необходимости

payout.payoutSplits.splitCommissions.merchantCms.currency Буквенный код валюты комиссии по ISO String(3) При необходимости

payout.payoutSplits.orderId Номер заказа String При необходимости

type Тип уведомления — только PAYOUT String Всегда

version Версия уведомлений String Всегда

Формат уведомления CAPTURE

Пример тела уведомления CAPTURE

capture Описание операции подтверждения Object

capture.type Тип операции — только CAPTURE String(200)

capture.paymentId Идентификатор платежа в системе ТСП String(200)

capture.captureId Идентификатор подтверждения в системе ТСП String(200)

capture.createdDateTime Дата создания операции URL-закодированная строкаГГГГ-ММ-ДДTчч:мм:ссZ

capture.amount Информация о сумме операции Object

capture.amount.value Сумма операции, округленная до двух десятичных знаков в меньшую сторону Number(6.2)

capture.amount.currency Идентификатор валюты операции (Alpha-3 ISO 4217 код) String(3)

capture.billId ID счета, соответствующего операции String(200)

capture.status Информация о статусе операции Object

capture.status.value Строковое значение статуса String

capture.status.changedDateTime Дата обновления статуса URL-закодированная строкаГГГГ-ММ-ДДTчч:мм:ссZ

capture.status.reasonCode Код причины отклонения String(200)

capture.status.reasonMessage Описание причины отклонения String(200)

capture.status.errorCode Код ошибки Number

capture.paymentMethod Информация о средстве платежа Object

capture.paymentMethod.type Тип метода оплаты String

capture.paymentMethod.maskedPan Маскированный PAN карты String

capture.paymentMethod.rrn RRN платежа (по ISO 8583) Number

capture.paymentMethod.authCode Auth-code платежа Number

capture.merchantSiteUid Строковый идентификатор сайта ТСП в QIWI Кассе String

capture.customer Информация о покупателе Object

capture.customer.phone Номер телефона покупателя String

capture.customer.email E-mail покупателя String

capture.customer.account Идентификатор покупателя в системе ТСП String

capture.customer.ip IP адрес покупателя String

capture.customer.country Страна адреса покупателя String

capture.customFields Поля с произвольной информацией, дополняющей данные по операции Object

capture.customFields.cf1 Поле с произвольной информацией, дополняющей данные по операции String(256)

capture.customFields.cf2 Поле с произвольной информацией, дополняющей данные по операции String(256)

capture.customFields.cf3 Поле с произвольной информацией, дополняющей данные по операции String(256)

capture.customFields.cf4 Поле с произвольной информацией, дополняющей данные по операции String(256)

capture.customFields.cf5 Поле с произвольной информацией, дополняющей данные по операции String(256)

capture.flags Дополнительные команды, переданные в API Array(Strings). Возможные элементы: SALE, REVERSAL

capture.settlementAmount Сведения о сумме расчёта с мерчантом Object Если валюта платежа и расчёта с мерчантом различаются

capture.settlementAmount.value Сумма расчёта с мерчантом Number(6.2) Если валюта платежа и расчёта с мерчантом различаются

capture.settlementAmount.currency Идентификатор валюты расчёта с мерчантом (Alpha-3 ISO 4217 код) String(3) Если валюта платежа и расчёта с мерчантом различаются

type Тип уведомления — только CAPTURE String

Тестирование проведения операций

При подключении идентификатор сайта партнёра siteId находится в тестовом режиме. В этом режиме партнёр может проводить операции без списания средств с банковской карты. Также можно запросить переключение в режим тестирования любого siteId партнёра, либо добавление нового siteId в режиме тестирования через сопровождающего менеджера.

Для операций в тестовом режиме используются стандартные URL API Протокола.

Тестовый режим для метода оплаты с баланса КИВИ Кошелька не предусмотрен.

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

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

При необходимости измените постоянный URL для обработки уведомлений с тестового (например, https://your-shop-test.ru/callbacks) на производственный (например, https://your-shop-prod.ru/callbacks) в Личном кабинете.

Как подключить мобильный банк?

Чтобы подключить сервис, можно воспользоваться любым, наиболее удобным для себя способом:

Абоненты, уже зарегистрированные в банке, также могут подключить «Мобильный банк», позвонив на сервисный номер 900 (только с мобильного) или через службу «Сбербанк Онлайн».

Обнаружили ошибку? Выделите ее и нажмите Ctrl + Enter.

не нашёл то, что искал

содержание не соответствует заголовку

информация сложно подана

Расскажите, что вам не понравилось на странице:

Спасибо за отзыв, вы помогаете нам развиваться!

Оплата СБП

В тестовом режиме можно через API только выпускать QR-код СБП и запрашивать его статус. Для тестирования разных вариантов ответов указывайте разные суммы платежа (поле amount.value):

При запросе статуса платежа СБП в тестовом режиме доступно ограниченное количество статусов:

Чтобы создать платеж, передайте в запросе API Платеж:

Платеж через форму мерчанта

При подключении платежей через собственную платежную форму по умолчанию доступен только способ оплаты Банковские карты. Другие способы оплаты доступны по запросу:

Удаление платежного токена

Удаление платежного токена

Чтобы прекратить действие платежного токена, отправьте запрос DELETE:

В JSON-теле запроса укажите параметры:

Успешный ответ означает, что платежный токен для указанного покупателя больше не действует.

Этот метод действует как для платежного токена карты, так и для платежного токена QIWI Кошелька.

В Протоколе доступны следующие операции:

Статус выплаты

Пример запроса статуса выплаты

"some comment for payout operation"

"Incorrect payout amount"

Выпуск платежного токена карты

Пример запроса выставления счета с выпуском платежного токена

Пример запроса платежа с выпуском платежного токена

Пример тела ответа с платежным токеном

Для выпуска платежного токена карты вы можете использовать два способа:

Подробнее о том, как использовать платежный токен, см. ссылки:

Формат уведомления CHECK_CARD

Пример тела уведомления CHECK_CARD

checkPaymentMethod Описание результата проверки карты Object

checkPaymentMethod.checkOperationDate Дата проверки карты URL-закодированная строкаГГГГ-ММ-ДДTчч:мм:ссZ

checkPaymentMethod.requestUid Идентификатор операции проверки карты String

checkPaymentMethod.status Статус проверки карты String

checkPaymentMethod.isValidCard Признак доступности карты для платежей Bool

checkPaymentMethod.threeDsStatus Информация о статусе дополнительной аутентификации при проверке карты. Возможные значения: PASSED (3-D Secure пройден), NOT_PASSED (3-D Secure не пройден), WITHOUT (3-D Secure не требовалось) String

checkPaymentMethod.paymentMethod Информация о средстве платежа Object

checkPaymentMethod.paymentMethod.type Тип метода оплаты String

checkPaymentMethod.paymentMethod.maskedPan Маскированный PAN карты String

checkPaymentMethod.paymentMethod.cardExpireDate Срок действия карты String

checkPaymentMethod.paymentMethod.cardHolder Имя держателя карты String

checkPaymentMethod.cardInfo Информация о карте Object

checkPaymentMethod.cardInfo.issuingCountry Код страны эмитента String(3)

checkPaymentMethod.cardInfo.issuingBank Банк-эмитент String

checkPaymentMethod.cardInfo.paymentSystem Тип платежной системы String

checkPaymentMethod.cardInfo.fundingSource Тип карты String

checkPaymentMethod.cardInfo.paymentSystemProduct Категория карты String

checkPaymentMethod.createdToken Объект с информацией о платежном токене, выпущенном вместе с проверкой карты Object

checkPaymentMethod.createdToken.token Строка платежного токена String

checkPaymentMethod.createdToken.name Маскированный PAN карты, для которой выпущен платежный токен String

checkPaymentMethod.createdToken.expiredDate Дата окончания срока действия платежного токена. Формат даты соответствует стандарту ISO-8601:ГГГГ-ММ-ДДTчч:мм:сс±чч:мм String

checkPaymentMethod.createdToken.account Идентификатор покупателя, указанный при выпуске платежного токена String

checkPaymentMethod.merchantSiteUid Строковый идентификатор сайта ТСП в QIWI Кассе String

type Тип уведомления — только CHECK_CARD String

См. описание тестового режима для выплат.

Оплата со счета мобильного телефона

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

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

При отправке платежа укажите в блоке paymentMethod в запросе API Платеж параметры:

Выставление счета и получение ссылки на оплату через API

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

Двухшаговый платеж

Выставление счета с оплатой через холдирование (двухшаговый платеж)

Уведомление об оплате счета

Одношаговый платеж

Выставление счета с оплатой без авторизации Покупателя (одношаговый платеж)

Выставление счета с оплатой платежным токеном

Подробнее о выпуске платежного токена см. в этом разделе.

Чтобы покупатель смог оплатить платежным токеном:

Для списания средств по платежному токену без участия Покупателя воспользуйтесь методом API Платеж. См. подробнее описание использования платежного токена на Платежной форме мерчанта.

Получение списка платежей по счету

Пример запроса на получение списка платежей по счету

"Детская футбольная школа «Тигры»""Детская футбольная школа «Тигры»"

Оплата через СБП

Протокол приема платежей поддерживает списание средств с покупателя через Систему быстрых платежей (СБП). Через СБП можно выполнять платежи в пользу юридических лиц, в том числе с использованием QR-кодов.

По умолчанию прием оплаты через СБП отключен. Чтобы подключить этот способ оплаты, обратитесь к вашему сопровождающему менеджеру.

Пример тела запроса для платежа через СБП

Пример ответа c QR-кодом

При оплате через СБП покупатель сканирует QR-код и получает ссылку на платеж, которую можно открыть в приложении своего банка.

Для выпуска QR-кода СБП отправьте запрос API Получение QR-кода СБП. В запросе укажите:

В ответе на запрос в объекте qrCode содержатся данные QR-кода:

Статус платежа через СБП

После перехода платежа в финальный статус вы получите уведомление с указанным в исходном запросе идентификатором выпуска QR-кода в поле qrCodeUid. Актуальный статус платежа по идентификатору платежа paymentId из уведомления можно получить через API.

Пример ответа на запрос статуса QR-кода

Используйте запрос Статус QR-кода СБП. В ответе возвращается информация о QR-коде, в том числе его текущий статус. Так вы можете определить действует ли QR-код.

Оплата токеном через СБП

Пример тела запроса оплаты токеном СБП

О выпуске платежного токена читайте подробнее в этом разделе.

Воспользуйтесь методом API Платеж токеном СБП и передайте в запросе:

Тестирование оплаты СБП

См. информацию в этом разделе.