Решить проблему с оплатой телефоном через tinkoff pay

Метод для получения информации по БС для обоих типов сделки (N)

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

Значение поля Status для сделки

Метод отмены созданного счета:

В ответ на корректно сформированный запрос система возвращает сообщение об успешно выполненной операции.

Google Pay в мобильных приложениях

Используйте Google Pay API для получения PaymentData и метод оплаты по криптограмме в API для проведения платежа.

При формировании запроса на платежные данные укажите тип оплаты через шлюз: Wallet-Constants.PAYMENT_METHOD_TOKENIZATION_TYPE_PAYMENT_GATEWAY и добавьте два параметра:

ваш Public ID

Выгрузка списка транзакций

Метод выгрузки списка транзакций за день.

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

Оплата товаров в example.com Повторите попытку позже

Статусы подписок (рекуррент)

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

Длинная запись

Длинная запись для авиа (airline addendum) — расширенная информация о маршрутной квитанции, которая передается вместе с транзакцией на обработку в платежную систему. Использование длинной записи позволяет сократить риски мошеннических операций и снизить стоимость обработки платежа.

Длинная запись состоит из информации о маршрутной квитанции, информации о сегментах, то есть перелетах и информации о пассажирах.

Информация о маршрутной квитанции включает в себя:

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

Для передачи информации о пассажирах, необходимо по каждому указать имя и фамилию латиницей:
Длинную запись можно передать в систему в параметре AirlineAddendum при вызове метода оплаты через API или в ответе на запрос проверки платежа.
Пример формирования длинной записи:
## SDK для Android
SDK позволяет интегрировать прием платежей в мобильные приложение для платформы Android. Основная версия находится на Github.
Из приложения вы узнаете, как получить карточные данные, сформировать криптограмму, провести 3-D Secure авторизацию и выполнить платеж на Android.
## Коды ошибок
Ниже представлены коды ошибок, которые определяют причину отказа в проведении платежа.
Сообщение для плательщика виджет показывает самостоятельно, а в API за него отвечает параметр CardHolderMessage.
| Код | Название | Причина | Сообщение для плательщика |
|------|------------------------|------------------------------------------------------------------------------------------------------------|-------------------------------------------------------------|
| 5001 | Refer To Card Issuer | Отказ эмитента проводить онлайн-операцию | Свяжитесь с вашим банком или воспользуйтесь другой картой |
| 5003 | Invalid Merchant | Отказ эмитента проводить онлайн-операцию | Свяжитесь с вашим банком или воспользуйтесь другой картой |
| 5004 | Pick Up Card | Карта потеряна | Свяжитесь с вашим банком или воспользуйтесь другой картой |
| 5005 | Do Not Honor | Отказ эмитента без объяснения причин | - неверно указан код CVV на картах Mastercard; - внутренние ограничения банка, выпустившего карту; - карта заблокирована или еще не активирована; - на карте не включены интернет-платеж... |
| 5006 | Error | Отказ сети проводить операцию или неправильный CVV-код | Проверьте правильность введенных данных карты или воспользуйтесь другой картой |
| 5007 | Pick Up Card Special Conditions | Карта потеряна | Свяжитесь с вашим банком или воспользуйтесь другой картой |
| 5012 | Invalid Transaction | Карта не предназначена для онлайн-платежей | Воспользуйтесь другой картой или свяжитесь с банком, выпустившим карту |
| 5013 | Amount Error | Слишком маленькая или слишком большая сумма операции | Проверьте корректность суммы |
| 5014 | Invalid Card Number | Некорректный номер карты | Проверьте правильность введенных данных карты или воспользуйтесь другой картой |
| 5015 | No Such Issuer | Эмитент не найден | Проверьте правильность введенных данных карты или воспользуйтесь другой картой |
| 5017 | Customer Cancellation | Отказ по желанию держателя карты | Воспользуйтесь другой картой |
| 5019 | Transaction Error | Отказ эмитента без объяснения причин | - неверно указан код CVV на картах Mastercard; - внутренние ограничения банка, выпустившего карту; - карта заблокирована или еще не активирована; - на карте не включены интернет-платеж... |
| 5030 | Format Error | Ошибка на стороне эквайера — неверно сформирована транзакция | Повторите попытку позже |
| 5031 | Bank Not Supported By Switch | Неизвестный эмитент карты | Воспользуйтесь другой картой |
| 5033 | Expired Card Pickup | Истек срок утери карты | Свяжитесь с вашим банком или воспользуйтесь другой картой |

5034 Подозрение на мошенничество — Отказ эмитента

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

5036 Карта ограничена

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

5041 Потерянная карта

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

5043 Украденная карта

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

5051 Недостаточно средств

Если на вашей карте недостаточно средств, попробуйте воспользоваться другой картой.

5054 Просроченная карта

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

5055 Неверный PIN-код

Если вы ввели неверный PIN-код, попробуйте воспользоваться другой картой.

5057 Ограничения на транзакцию

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

5058 Транзакция не разрешена по карте

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

5059 Отклонение транзакции по подозрению в мошенничестве

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

5061 Превышена сумма по карте

Если превышена сумма по карте, воспользуйтесь другой картой.

5062 Карта ограничена

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

5063 Нарушение безопасности

Если ваша карта заблокирована из-за нарушений безопасности, воспользуйтесь другой картой.

5065 Превышен лимит операций по карте

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

5082 Неверный CVV-код

Если введен неверный CVV-код, воспользуйтесь другой картой.

5091, 5092, 5096 Ошибки сети или системы банка

Если произошла ошибка сети или системы банка, повторите попытку позже или воспользуйтесь другой картой.

5113 Шлюз не поддерживает эмитента

Если шлюз не поддерживает эмитента, воспользуйтесь другой картой.

5204 Операция не может быть обработана

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

5206, 5207 Ошибка аутентификации 3-D Secure

Если произошла ошибка аутентификации 3-D Secure, свяжитесь с вашим банком или воспользуйтесь другой картой.

5300 Лимиты эквайера на проведение операций

Если превышены лимиты эквайера на проведение операций, воспользуйтесь другой картой.

5761, 5762, 5763 Проблемы с номером телефона

Если у вас возникают проблемы с номером телефона, воспользуйтесь другой картой.

Сценарии интеграции

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

Способы оплаты

(complete the translation into Russian)

## Оплату можно проводить следующими способами:
## Отправка покупателю онлайн-чека
На выбор покупателя кассовый чек необходимо отправить в письме на e-mail адрес или в СМС, Viber, WhatsApp, Telegram сообщении на номер телефона. Чек может быть отправлен системой CloudPayments автоматически, при условии передачи e-mail адреса или номера телефона покупателя, или же вы самостоятельно можете отправлять чек — все необходимые реквизиты система передает в уведомлении Receipt.
## Тестирование онлайн-чека
При работе в тестовом режиме кассовые чеки будут формироваться в демонстрационной ККТ с отладочным фискальным накопителем. Вы можете передать данные для онлайн-чека при оплате в тестовом режиме и проверить работу онлайн-кассы.
## Запуск и остановка регулярных платежей
Запуск рекуррентных платежей возможен в любое время после выполнения установочного платежа: в тот же момент, через неделю или через месяц. Ограничение только одно - интервал между регулярными платежами, а также между установочным и первым регулярным платежом не может превышать один год.
Пример: покупатель оплачивает первый месяц предоставления услуг через установочный платеж и дает согласие на ежемесячное списание с его карты начиная со второго месяца. Запуск регулярных платежей может быть выполнен через API или платежный виджет.
Если покупатель отказывается от дальнейших платежей, вы можете отменить подписку в любой момент:
Также плательщик может самостоятельно найти и отменить свои регулярные платежи на сайте системы CloudPayments.
## Просмотр настроек уведомлений
Метод просмотра настроек уведомлений с указанием типа уведомления.
| Type | String | Обязательный |
|--------|--------------|--------------|
| | Тип уведомления: Check/Pay/Fail и т.д. (см. справочник) |
Сразу после создания нового сайта в ЛК он находится в тестовом режиме работы — это значит, что платежи и прочие операции будут проходить в режиме эмуляции.
## Таблица для тестирования карт:
| Тип | Номер карты | Результат оплаты | Результат оплаты по токену |
|-----------------------------------------|----------------------------|------------------|----------------------------|
| Карта Visa с 3-D Secure | 4242 4242 4242 4242 | Успешный результат | Успешный результат |
| Карта Mastercard с 3-D Secure | 5555 5555 5555 4444 | Успешный результат | Успешный результат |
| Карта Visa с 3-D Secure | 4012 8888 8888 1881 | Недостаточно средств на карте | |
| Карта Mastercard с 3-D Secure | 5105 1051 0510 5100 | Недостаточно средств на карте | |
| Карта Visa без 3-D Secure | 4000 0000 0000 3055 | Успешный результат | Успешный результат |
| Карта Mastercard без 3-D Secure | 5205 0000 0000 3055 | Успешный результат | Успешный результат |
| Карта Visa без 3-D Secure | 4111 1111 1111 1111 | Успешный результат | Недостаточно средств на карте |
| Карта Mastercard без 3-D Secure | 5200 8282 8282 8210 | Успешный результат | Недостаточно средств на карте |
| Карта Visa без 3-D Secure | 4000 0566 5566 5556 | Недостаточно средств на карте | |
| Карта Mastercard без 3-D Secure | 5404 0000 0000 0043 | Недостаточно средств на карте | |
## Установка
Для создания криптограммы необходимо прописать на странице с платежной формой скрипт checkout.
Выбрать удобный для вас вариант передачи карточных данных:

Далее созданную криптограмму карты необходимо отправить на сервер и вызывать метод оплаты через API.

Вариант с передачей карточных данных напрямую в скрипт

1. Инициализировать скрипт checkout

2. Вызвать метод генерации криптограммы, передав в него карточные данные

// При вводе карт платежной системы Humo/UzCard данное поле не обязательно, системой не проверяется 8600 0000 0000 0007

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

1. Создать форму для ввода карточных данных:

Поля ввода карточных данных должны быть помечены атрибутами:

2. Инициализировать скрипт checkout

3. Вызвать метод генерации криптограммы

При разработке собственной формы или передачи данных в скрипт обратите внимание на следующие моменты

Checkout — уникальная технология токенизации карт для приема платежей на вашем сайте, в форме без встроенных iframe элементов, что дает максимальный контроль и конверсию прохождения платежей. Данные платежных карт шифруются в браузере покупателя, поэтому ваш сайт не принимает участие в обработке и хранении номеров, что значительно сокращает область применения требований PCI DSS. Тем не менее, сайт влияет на безопасность карточных данных и для его защиты необходимо выполнять сканирование не менее одного раза в квартал для поиска вирусов и уязвимостей. Сканирование должно проводиться аккредитованным вендором (ASV) из списка, представленного на сайте совета PCI.

Проверка статуса платежа

Метод поиска платежа и проверки статуса (см. справочник).

Адрес старого метода: https://api.cloudpayments.uz/payments/find

Адрес нового метода: https://api.cloudpayments.uz/v2/payments/find

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

Принцип работы

Выбор формата передачи параметров определяется на стороне клиента и управляется через заголовок запроса Content-Type.

Ответ система выдает в JSON-формате, который как минимум включает в себя два параметра: Success и Message:

"Invalid Amount value"

Рекуррентные платежи

Рекуррентные платежи, также известные как платежи по подписке или «автоплатежи» — возможность выполнять регулярные списания денег с банковской карты покупателя без повторного ввода реквизитов карты и без участия плательщика для инициации очередного платежа.

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

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

Оплата в рассрочку

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

//по умолчанию 12000 сум разом //6 месяцев по 1000 сум начиная со следующего месяца //сумма первого платежа — 6000 сум. //id из личного кабинета //идентификатор плательщика (обязательно для создания подписки) //действие при успешной оплате //действие при неуспешной оплате

Запуск сессии для оплаты через Apple Pay

Запуск сессии необходим для приема платежей Apple Pay на сайтах. Для оплаты в мобильных приложениях его использование не требуется.

ValidationUrl Строка Обязательный Адрес, полученный из Apple JS

paymentUrl Строка Необязательный Адрес для старта сессии в Apple

В ответ на корректно сформированный запрос система возвращает ответ, где в объекте Model содержится сессия для оплаты Apple Pay в формате JSON.

Cancel

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

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

TransactionId Long Обязательный Номер отмененной транзакции в системе

Amount Numeric, точка в качестве разделителя, две цифры после точки Обязательный Сумма отмененной транзакции в валюте платежа

DateTime yyyy-MM-dd HH:mm:ss Обязательный Дата/время отмены по временной зоне UTC

InvoiceId String Необязательный Номер заказа отмененной операции

AccountId String Необязательный Идентификатор пользователя отмененной операции

Email String Необязательный E-mail адрес плательщика

Data Json Необязательный Произвольный набор параметров, переданных в транзакцию

В ответ на запрос система ожидает получить ответ в JSON-формате с обязательным параметром code:

Код определяет результат обработки сервером ТСП уведомления и может принимать единственное значение:

Проверка и регистрация платежей

Если вам необходимо проверять и регистрировать платежи в своей системе, ваши действия следующие:

Оплата по криптограмме

Метод для оплаты по криптограмме платежных данных результат алгоритма шифрования. Для формирования криптограммы воспользуйтесь скриптом Checkout, Apple Pay или Google Pay.

Адреса метода: https://api.cloudpayments.ru/payments/cards/charge — для одностадийного платежа https://api.cloudpayments.ru/payments/cards/auth — для двухстадийного

Amount Number Обязательный Cумма платежа в валюте, разделитель точка. Количество не нулевых знаков после точки – 2

Currency String Необязательный Валюта: RUB/USD/EUR/GBP (см. справочник). Если параметр не передан, то по умолчанию принимает значение RUB

CardCryptogramPacket String Обязательный Криптограмма платежных данных

Name String Необязательный Имя держателя карты латиницей

PaymentUrl String Необязательный Адрес сайта, с которого совершается вызов скрипта checkout

InvoiceId String Необязательный Номер счета или заказа

Description String Необязательный Описание оплаты в свободной форме

CultureName String Необязательный Язык уведомлений. Возможные значения: "ru-RU", "en-US". (см. справочник)

AccountId String Необязательный Обязательный идентификатор пользователя для создания подписки и получения токена

Email String Необязательный E-mail плательщика, на который будет отправлена квитанция об оплате

Payer Object Необязательный Доп. поле, куда передается информация о плательщике. Используйте следующие параметры: FirstName, LastName, MiddleName, Birth, Street, Address, City, Country, Phone, Postcode

JsonData Json Необязательный Любые другие данные, которые будут связаны с транзакцией, в том числе инструкции для создания подписки или формирования онлайн-чека должны обёртываться в объект cloudpayments. Мы зарезервировали названия следующих параметров и отображаем их содержимое в реестре операций, выгружаемом в Личном Кабинете: name, firstName, middleName, lastName, nick, phone, address, comment, birthDate.

SaveCard bool Необязательный Признак сохранения карточного токена для проведения оплаты по сохранённой карте (см. Оплата по токену (рекарринг)). Возможные значения: true — после успешной оплаты будет возвращён карточный токен, false — токен не будет возвращаться (по-умолчанию) Параметр SaveCard обрабатывается только при включении настройки "Сохранение токена карты" в Личном Кабинете. При включении настройки "Сохранять принудительно", параметр SaveCard будет игнорироваться.

В ответ сервер возвращает JSON с тремя составляющими:

Возможные варианты ответа:

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

"Оплата товаров в example.com" "тестовый проезд дом тест"

Пример ответа: некорректный запрос:

"Amount is required"

Пример ответа: требуется 3-D Secure аутентификация:

Пример ответа: транзакция отклонена. В поле ReasonCode код ошибки (см. справочник):

"Оплата товаров в example.com" "Недостаточно средств на карте"

Пример ответа: транзакция принята:

"Оплата товаров в example.com" "Visa Signature (Signature)" "Оплата успешно проведена"

SDK для iOS

SDK позволяет интегрировать прием платежей в мобильные приложение для платформы iOS. Основная версия находится на GitHub.

Из приложения вы узнаете как получить карточные данные, сформировать криптограмму, провести 3-D Secure авторизацию и выполнить платеж на iPhone или iPad.

Recurrent

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

Description String Обязательный Назначение платежа в свободной форме

Currency String Обязательный Валюта: RUB/USD/EUR/GBP из параметров платежа (см. справочник)

RequireConfirmation Bool Обязательный Если значение true — платеж будет выполнен по двухстадийной схеме

StartDate DateTime Обязательный Дата и время первого платежа по плану во временной зоне UTC

Interval String Обязательный Интервал. Возможные значения: Week, Month

Period Int Обязательный Период. В комбинации с интервалом 1 Month значит раз в месяц, а 2 Week — раз в две недели

SuccessfulTransactionsNumber Int Обязательный Количество успешных платежей

FailedTransactionsNumber Int Обязательный Количество неуспешных платежей (обнуляется после каждого успешного)

MaxPeriods Int Необязательный Максимальное количество платежей в подписке

LastTransactionDate yyyy-MM-dd HH:mm:ss Необязательный Дата и время последнего успешного платежа во временной зоне UTC

NextTransactionDate yyyy-MM-dd HH:mm:ss Необязательный Дата и время следующего платежа во временной зоне UTC

Код определяет результат обработки сервером ТСП уведомления об изменении подписки и может принимать единственное значение:

Автоплатежи для интернет-провайдеров

Платежное решение подходит для интернет-провайдеров, операторов связи и телекомов. Уведомления на проверку и регистрацию платежей могут быть настроены как в формате CloudPayments, так и в формате QIWI (ОСМП).

//минус один день //один раз в месяц начиная со следующего месяца за минусом одного дня //id из личного кабинета Пополнение счета абонента //идентификатор плательщика (обязательно для создания подписки) //действие при успешной оплате //действие при неуспешной оплате

Установка виджета

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

Для появления платежной формы необходимо зарегистрировать функцию для вызова метода pay, передав в него параметр auth или charge:

// или ‘charge’ //id из личного кабинета Оплата товаров в example.com //идентификатор плательщика (необязательно) //номер заказа (необязательно) //email плательщика (необязательно) //дизайн виджета (необязательно) //время в секундах до авто-закрытия виджета (необязательный) //действие при успешной оплате //действие при неуспешной оплате //Вызывается как только виджет получает от api.cloudpayments ответ с результатом транзакции.

И прописать вызов функции на событие, например, нажатие кнопки «Оплатить»:

Демонстрация работы виджета представлена в нашем демо-магазине.

Пример реализации запуска виджета без библиотеки jquery:

Для тестирования можно использовать как тестовые карточные данные, так и реальные. Списания денежных средств не произойдет.

Карта МИР с 3-D Secure 2200 0000 0000 0004 Успешный результат Успешный результат

Карта МИР с 3-D Secure 2202 2022 0220 2200 Недостаточно средств на карте —

Карта МИР без 3-D Secure 2202 0000 0000 3055 Успешный результат Успешный результат

Карта МИР без 3-D Secure 2200 0000 2222 2222 Успешный результат Недостаточно средств на карте

Карта МИР без 3-D Secure 2203 0000 0000 0043 Недостаточно средств на карте —

Виды операций

Система предполагает два вида операций: оплата и возврат.

Создание счета для отправки по почте

Метод формирования ссылки на оплату и последующей отправки уведомления на e-mail адрес плательщика.

Currency String Необязательный Валюта RUB/USD/EUR/GBP (см. справочник). Если параметр не передан, то по умолчанию принимает значение RUB

RequireConfirmation Bool Необязательный Есть значение true — платеж будет выполнен по двухстадийной схеме

SendEmail Bool Необязательный Если значение true — плательщик получит письмо со ссылкой на оплату

InvoiceId String Необязательный Номер заказа в вашей системе

AccountId String Необязательный Идентификатор пользователя в вашей системе

OfferUri String Необязательный Ссылка на оферту, которая будет показываться на странице заказа

Phone String Необязательный Номер телефона плательщика в произвольном формате

SendSms Bool Необязательный Если значение true — плательщик получит СМС со ссылкой на оплату

SendViber Bool Необязательный Если значение true — плательщик получит сообщение в Viber со ссылкой на оплату

SubscriptionBehavior String Необязательный Для создания платежа с подпиской. Возможные значения: CreateWeekly, CreateMonthly

SuccessRedirectUrl String Необязательный Адрес страницы для редиректа при успешной оплате

FailRedirectUrl String Необязательный Адрес страницы для редиректа при неуспешной оплате

JsonData Json Необязательный Любые другие данные, которые будут связаны с транзакцией, в том числе инструкции для формирования онлайн-чека должны обёртываться в объект cloudpayments

"Оплата на сайте example.com"

Рекуррентные платежи (подписка)

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

Interval String Обязательный Интервал. Возможные значения: Day, Week, Month

Period Int Обязательный Период. В комбинации с интервалом, 1 Month значит раз в месяц, а 2 Week — раз в две недели. Должен быть больше 0

MaxPeriods Int Необязательный Максимальное количество платежей в подписке. По умолчанию стоит без ограничений. Если задаете количество, проверьте, чтобы оно было больше 0

Amount Numeric Необязательный Сумма регулярного платежа. По умолчанию совпадает с суммой первого, установочного платежа. Если указываете другую сумму, проверьте, чтобы она была больше 0

StartDate DateTime Необязательный Дата и время первого регулярного платежа. По умолчанию запуск произойдет через указанный интервал и период, например через месяц. Если указываете другую дату, то она должна стоять в будущем времени

CustomerReceipt String Необязательный Данные для формирования онлайн-чека в регулярных платежах

Параметры для запуска регулярных платежей необходимо добавить в объект data.CloudPayments.recurrent как в примере ниже::

// — обязательное поле // цена одного товара — обязательное поле // количество товара — обязательное поле // Сумма товара (price x quantity) — обязательное поле // Ставка НДС — обязательное поле, // код ИКПУ — обязательное поле // код упаковки — обязательное поле //, обязательное поле // цена одного товара, обязательное поле // количество товара, обязательное поле // сумма товара (price x quantity), обязательное поле // ставка НДС, обязательное поле // код ИКПУ, обязательное поле // код упаковки, обязательное поле Вы стали обладателем права на 1% cashback // Чек для первого платежа // Чек для регулярных платежей // Создание ежемесячной подписки // public_id из личного кабинета // Назначение платежа // Номер заказа // Идентификатор плательщика (обязательно для создания подписки) // Почта плательщика //действие при успешной оплате //действие при неуспешной оплате

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

Больше примеров создания рекуррентных платежей из виджета — в разделе "Сценарии интеграции".

Для отмены рекуррентных платежей используйте возможности личного кабинета, API или предоставьте покупателю ссылку на сайт системы — https://my.cloudpayments.uz/, где он самостоятельно сможет найти и отменить свои подписки.

API

API — программный интерфейс системы для взаимодействия с системами ТСП.

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

Мобильный виджет

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

// или ‘charge’ //id из личного кабинета Оплата товаров в example.com //идентификатор плательщика (необязательно) //номер заказа (необязательно) //email плательщика (необязательно) //дизайн виджета (необязательно) //время в секундах до авто-закрытия виджета (необязательный) // адреса для перенаправления // при оплате по Tinkoff Pay тестовый проезд дом тест //действие при успешной оплате //действие при неуспешной оплате //Вызывается как только виджет получает от api.cloudpayments ответ с результатом транзакции. //например вызов вашей аналитики

Создание подписки на рекуррентные платежи

Метод создания подписки на рекуррентные платежи.

Token String Обязательный Токен карты, выданный системой после первого платежа

Amount Numeric Обязательный Cумма платежа в валюте, разделитель точка. Количество не нулевых знаков после точки – 2.

Currency String Обязательный Валюта: UZS/USD/EUR/GBP (см. справочник)

RequireConfirmation Bool Обязательный Если значение true — платежи будут выполняться по двухстадийной схеме

StartDate DateTime Обязательный Дата и время первого платежа по плану во временной зоне UTC. Значение должно быть в будущем

MaxPeriods Int Необязательный Максимальное количество платежей в подписке. Если указан, должен быть больше 0

CustomerReceipt json Необязательный Для изменения состава онлайн-чека

В ответ на корректно сформированный запрос система возвращает сообщение об успешно выполненной операции и идентификатор подписки.

"Ежемесячная подписка на сервис example.com"

Момент отправки чека

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