Обзор протокола
Протокол приема платежей позволяет быстро и безопасно принимать платежи в интернете. Протокол позволяет вашим покупателям использовать различные методы оплаты:
- Банковские карты Visa, Mastercard, МИР.
- Yandex Pay.
- QIWI Кошелек.
- Система Быстрых Платежей (СБП).
- Баланс мобильного телефона.
Термины и сокращения
Ключ доступа к API — это строка токенов для авторизации торговца в API в соответствии со стандартом OAuth 2. 0 RFC 6749 RFC 6750.
Платежный токен — строка символов, созданная из данных карты для платежей без акцепта.
API: Интерфейс прикладного программирования — набор понятных методов, предоставляемых приложением (системой) для использования во внешнем программном обеспечении.
REST: Понимание государственной передачи — это стиль архитектурного общения между компонентами распределенного приложения онлайн.
3 DS: 3-D Secure, протокол защиты данных карты, используемый для аутентификации владельца карты во время транзакции онлайн-платежей. IWI работает с 3DS 1. 0 вариация и 3DS 2. Нулевые протоколы
ТСП, Мерчант — Торгово-сервисное предприятие.
Подключайте модуль для M PI для выполнения аутентификации покупателя 3DS.
Международные платежные системы для Visa и MasterCard создали P CI DSS или стандарт безопасности платежных карт.
Способы подключения
Протокол приема платежей поддерживает следующие типы коммуникаций:
- Оплата через форму QIWI.
- Оплата через форму продавца.
Типы операций
В этом протоколе доступны следующие операции:
- Счет-фактура — это электронный документ, выдаваемый продавцом покупателю. В нем содержится информация о сумме и номере заказа. Она не является финансовой структурой, и срок ее действия ограничен. Счет-фактура необходим для получения ссылки на форму оплаты QIWI.
- Платеж — операция аннулирования денежных средств покупателя в пользу продавца. Фактическая отмена происходит только после подтверждения (Capture). При использовании формы оплаты QIWI платеж является попыткой оплатить счет-фактуру (Invoice).
- Complete: завершение проверки 3DS покупателя. Используется при работе через платежную форму продавца.
- Capture — операция авторизации средств (дебетование).
- Refund — возврат денег покупателю при успешной оплате. Финансовая операция по списанию средств с продавца на покупателя. Если подтверждения платежной операции не было, вы получите флаг отмены в ответе на транзакцию возврата, и деньги не будут переведены со счета покупателя на счет продавца (комиссия за приобретение также не сохраняется).
Формат взаимодействия
API протокола приема платежей базируется на принципах архитектуры REST.
Параметры API находятся в запросе JSON. При проверке параметры GET помещаются в запрос URL.
A PI возвращает ответ в формате JSON.
Тестовый режим
В тестовом режиме с вашим сайтом. Вы можете проводить транзакции в этом режиме, не уплачивая никаких сборов. Вы можете попросить переключить любое из ваших сайтов в тестовый режим.
U RL протокола для проверки операций оплаты используются.
Тестовый режим для совершения платежей с использованием баланса в кошельке Киви отсутствует.
Мы переводим siteId в производственный режим после завершения интеграции вашей стороны. Списания в этом режиме являются фактическими.
Ключ API Access не должен быть выпущен снова, находясь в производственном режиме.
Оплата картой в тестовом режиме
Вы можете использовать любой номер карты, который удовлетворяет алгоритму Luhn в тестовом режиме.
Тестовые номера карт
В режиме тестирования валюты (параметр валюты) разрешен только рубль Российской федерации (643).
В тестовом режиме CVV может быть любым (произвольные 3 цифры).
.
- Если месяц окончания срока действия равен 02, операция завершится неудачей.
- Если месяц окончания срока действия равен 03, операция будет выполнена с задержкой в 3 секунды.
- Если месяц окончания срока действия равен 04, операция завершается с задержкой в 3 секунды.
- Во всех остальных случаях операция проходит успешно.
Объем и частота тестовых транзакций ограничены в среде тестирования. Максимальное количество тестовых транзакций по умолчанию составляет 10 рублей.100 транзакций разрешены в день в большинстве случаев (транзакции MSK для текущего дня и времени читаются). Транзакции, которые не превышают заранее определенного предела, принимаются во внимание.
Чтобы провести транзакцию с помощью 3DS, необходимо ввести строку неидентифицированного имени в имя владельца карты. Только после ввода фактического номера карты проверяется работа 3DS в тестовом режиме.
Оплата через СБП в тестовом режиме
Укажите различные суммы оплаты в поле суммы, чтобы проверить различные платежи и ответы.
- 200 — операция пройдет успешно с задержкой. При первом запросе статус платежа будет «LOOKED FOR», а после второго запроса статус платежа будет «VALID».
- При других суммах платеж не пройдет.
Платеж через форму QIWI
I WI-сервис не предоставляет возможности оплаты банковскими картами. Другие способы оплаты включаются по запросу
- Реквизиты платежной карты.
- Быстрая система оплаты. Кошелек QIWI.
Чтобы произвести оплату через форму Qiwi, выставите счет покупателю. Выставление счетов через API или перенаправление покупателя на форму Qiwi по прямой ссылке в настройках аккаунта.
Процесс платежа
sequenceDiagram
participant customer as Покупатель
participant store as Магазин
participant qb as QIWI (эквайер)
participant ips as Эмитент
customer->>store:Выбор товаров, Старт оплаты
activate store
store->>qb:Выставление счетаОдношаговый платеж — все способы оплатыДвухшаговый платеж — только карты
activate qb
qb->>store:Ссылка на платежную форму QIWI (payUrl)
store->>customer:Переадресация покупателя на payUrl
customer->>qb:Открытие платежной формы,выбор способа оплаты,указание платежных данных для выбранного способа
qb->>customer:Аутентификация покупателя:Для карт — 3-D Secure
customer->>qb:Аутентификация
qb->>ips:Запрос списания денежных средств
activate ips
ips->>qb:Статус операции
qb->>store:Уведомление о статусе операции
qb->>customer: Переадресация на страницу статуса платежа (successUrl)
rect rgb(237, 243, 255)
Note over store, ips:Двухшаговый платеж
store->>qb:Подтверждение операции (capture)
qb->>ips:Подтверждение списания
deactivate ips
qb->>store:Уведомление о подтверждении платежа
end
deactivate qb
deactivate store
Интеграция c Платежной формой QIWI без использования API
Это простой способ интеграции платежной формы QIWI.При открытии формы покупателю автоматически присваивается счет.Параметры подсчета передаются в открытом виде по ссылке на форму.Покупателю представляется платежная форма с выбором способа оплаты.
Вы должны предоставить ключ public_keo, чтобы получить доступ к форме в ссылке. Для каждого siteid доступен эксклюзивный ключ. Вы можете найти ключ в своем личном кабинете.
Этот способ оплаты автоматически авторизует платеж без участия продавца. Если используется двухэтапный процесс, для завершения транзакции необходимо запросить подтверждение платежа или подтвердить его через личный кабинет.
По умолчанию сервис IWI ожидает подтверждения платежа в течение 72 часов. По истечении срока автоматическое подтверждение платежа.
Установить счета для передачи суммы оплаты
При выставлении счета без указания суммы платежа (покупатель должен сам ввести сумму)
По умолчанию, после выплаты счета, аутентификация покупателя выполняется автоматически.Завершение аутентификации также происходит автоматически.
Выставление счета и получение ссылки на оплату через API
Иллюстрация двухэтапного платежа посредством выставления счетов через проведение
Пример выставления счета без авторизации Покупателя (одношаговый платеж)
Пример уведомления о оплате
Протокол принятия платежей разрешает выставление счетов как с разрешением карты покупателя, так и без нее.
- API-ключ;
- Сумма счета (amount);
- Срок действия (expiration dateTime);
- Информация о клиенте, адресе и получателе (receiverData);
- Дополнительные данные о транзакции (customFields).
- Перенаправьте покупателя на форму оплаты, используя ссылку в параметре ответа payUrl.
- Дождитесь завершения платежа: вы получите уведомление, или периодически отправляйте запрос API-выписки для получения информации о платеже.
Для двухшагового сценария (платеж с холдированием средств) требуется подтвердить платеж. Возврат осуществляется только после подтверждения.
Чтобы подтвердить платеж в двухсцентрированном
- Получить идентификатор платежа:
- Отправьте API-запрос на подтверждение платежа с полученным идентификатором платежа.
Платежный токен
Создайте счет с токеном платежей
Платежи используются для сохранения от карт или кошельков Qiwi без ввода деталей карты или номеров портфолио.Метод оплаты с помощью платежного токена по умолчанию избивается.Чтобы подключить его, свяжитесь с сопровождающим менеджером.
Прочитайте вопрос о токене платежа по ссылке.
Создайте счет -фактор платежного токена:
- Передайте в запросе API Создание счета следующую информацию:
ключ API;сумму счета (amount);дату, до которой необходимо оплатить счет (expirationDateTime);идентификатор покупателя, для которого был выпущен платежный токен, в параметре customer.account. Без этого параметра оплата платежным токеном невозможна.(опционально) другую информацию о счете. - ключ API;
- сумму счета (amount);
- дату, до которой необходимо оплатить счет (expirationDateTime);
- идентификатор покупателя, для которого был выпущен платежный токен, в параметре customer.account. Без этого параметра оплата платежным токеном невозможна.
- (опционально) другую информацию о счете.
- Перенаправьте покупателя на Платежную форму по ссылке из параметра payUrl ответа.
- Если для покупателя был выпущен один или несколько платежных токенов, то на Платежной форме отобразится список его привязанных карт.Для оплаты покупателю достаточно выбрать одну из своих привязанных карт. При этом не понадобится указывать карточные данные и проходить проверку 3-D Secure.
Используйте метод Payment API для списания платежного токена без участия Покупателя. Платежная форма торговца: Предоставляются подробные инструкции по использованию платежного токена.
Перенаправление на форму QIWI
Пример ответов от Payurl
Чтобы покупатель мог оплатить счет, перенаправьте его на платежную форму по ссылке в поле PayUrl в приложении счета.
По умолчанию QIWI 3-D Secure является обязательным в форме оплаты QIWI для покупателя.
Пример ссылки с успешным
В ссылку можно добавить следующий параметр:
Когда платеж успешен, используйте Parameter SuccessUrl для перенаправления. Переадресация происходит после успешной аутентификации 3DS. Передача ссылки в формате UTF-8 URL-WE
Пример обработки событий iframe
// заряженная форма
Очередная попытка платежа
// Платеж преуспел
Платеж не прошел
При открытии ссылок в:
Состояние формы будет показано в вашем браузере. В каком состоянии находится состояние?
- INITIALIZED — Форма загружена.
- PAYMENT_ATTEMPT — Попытка платежа.
- PAYMENT_SUCCEEDED — Платеж прошел успешно.
- PAYMENT_FAILED — Платеж не прошел.
- INITIALIZATION_FAILED — Ошибка загрузки формы.
Настройка Платежной формы
- Уникальный псевдоним стиля, связанный с SiteId (цифры, латинские буквы и тире -)
- Имя продавца, которое будет отображаться на форме
- Краткое описание бизнеса (максимум 120 символов)
- Логотип в формате PNG или SVG и размером 310×36 или пропорционально больше
- Цвет фона и цвет кнопки в формате HEX.
Необязательные данные для настройки
- Изображение для фона в формате PNG или SVG и размером 382×560 или пропорционально больше;
- Варианты заранее выбранных сумм оплаты (не более трех);
- Контактный e-mail для отображения на странице;
- URL страницы успешной оплаты;
- Номер счетчика Яндекс.Метрики;
- Ссылка на ваше предложение услуг.
Как передается параметр стиля при выставлении счета через API
Чтобы применить свой стиль к форме оплаты:
Название прозвища зависит от регистра.
Пример настройки Платежной формы:
Платеж через форму мерчанта
Банковские карты входят в стандартную комплектацию, когда вы подключаете платежи с помощью собственной формы оплаты. По запросу доступны дополнительные варианты оплаты:
- Платежные токены для карт и QIWI Wallet.
- Yandex Pay.
- Система быстрых платежей (FPS).
- Баланс мобильного телефона.
Процесс платежа
sequenceDiagram
participant customer as Покупатель
participant store as Магазин
participant qb as QIWI (эквайер)
participant ips as Эмитент
customer->>store:Выбор товаров, Старт оплаты,ввод платежных данных
activate store
store->>qb:ПлатежОдношаговый платеж — все способы оплатыДвухшаговый платеж — только карты
activate qb
qb->>store:Статус операции, данные для 3DS или QR-код СБП
rect rgb(237, 243, 255)
Note over customer, ips:3-D Secure
store->>customer:Переадресация покупателя на acsUrl или в приложение банка
activate ips
ips->>customer:Аутентификация покупателя:3DS — карты,СБП — подтверждение операции в интерфейсе эмитента карты
customer->>ips:Аутентификация
ips->>store:Результат аутентификации (PaRes)
store->>qb:Завершение аутентификации (complete)
end
qb->>ips:Запрос списания денежных средств
activate ips
ips->>qb:Статус операции
qb->>store:Уведомление о статусе операции
rect rgb(237, 243, 255)
Note over store, ips:Двухшаговый платеж
store->>qb:Подтверждение операции (capture)
qb->>ips:Подтверждение списания
deactivate ips
qb->>store:Уведомление о подтверждении платежа
end
deactivate qb
deactivate store
Чтобы создать платеж, перевод платежа в запросе:
- API ключ;
- Сумма платежа;
- Способ платежа;
- Другая информация для создания платежа.
Банковская карта
Протокол оплаты предусматривает двухэтапную транзакцию, при которой средства удерживаются на карте как покупателя, так и студента.
Создание платежа
Пример двухшагового платежа (двухмаховый)
Пример немедленного платежа (одномоментная оплата)
Чтобы инициировать оплату из зарезервированных средств (двухэтапный платеж), в заявке следует сделать перевод:
- API ключ;
- Сумма платежа;
- Способ оплаты CARD и данные карты покупателя;
- Другая информация для настройки оплаты.
В случае двухэтапного платежа возврат генерируется только после подтверждения платежа.
Ожидание аутентификации покупателя (3-D Secure)
Пример ответа с требованием утверждения покупателя
Уменьшение для идентификации сохранения 3D данных требуется для аутентификации 3-D Secure.
Покупатель скоро сможет пройти процесс аутентификации.
Если требуется покупка 3DS, от эмитента требуется дополнительная проверка.
- AcsUrl — URL-адрес сервера аутентификации 3-D Secure для перенаправления на страницу подтверждения отправителя;
- Pareq — зашифрованный запрос на аутентификацию 3-D Secure.
Сделайте запрос на URL-адрес сервера 3-D безопасного аутентификации со следующими параметрами, чтобы получить результат проверки (PARES):
- TermUrl — URL для перенаправления клиента после успешной аутентификации 3-D Secure;
- MD — уникальный идентификатор транзакции;
- PaReq — значение параметра pareq ответа на запрос платежа.
Для сохранения обратной совместимости использование 3D SAFE 1.0 или 3D Protocol 2.0 не влияет на интеграцию с интерфейсом API.
Информация о покупателе отправляется в платежную систему карты. Банк-эмитент может решить, что необходимо утвердить временный пароль или разрешить списание средств без аутентификации. После успешного завершения проверки покупатель информируется о результатах в параметре Pares.
Перейдите в запрос API, чтобы завершить аутентификацию клиента.
- Уникальный идентификатор торговца
- Номер платежа (параметр paymentId) из ответа на запрос платежа
- Оценка 3-D Secure (значение параметра PaRes).
Подтверждение платежа
Только двухэтапный платеж с призывами к этому действию.
Для подтверждения платежа нажмите play.
- Получите paymentId платежа:
Из серверного уведомления после успешного холдирования средств.Из ответа на запрос Статус платежа. - Из серверного уведомления после успешного холдирования средств.
- Из ответа на запрос Статус платежа.
- Отправьте запрос API Подтверждение платежа с полученным paymentId.
Платежный токен
Использование платежного токена в платежном запросе
Без ввода номера карты или пароля кошелька платежные токены используются для списания денег. При использовании платежного токена метод оплаты по умолчанию отключен. Для его подключения обратитесь к своему ассистирующему менеджеру.
Читайте о проблеме платежного токена по ссылке.
Чтобы заплатить за покупку с токеном платежа, вы должны перевести платеж по запросу:
- Платежный токен в объекте paymentMethod,
- Идентификатор клиента, для которого был выпущен платежный токен, в параметре customer.account.
Параметрический фрейм. Примером операции является typestring. Один и только tokenpaymentMethod Ссылка на tokencustomer для платежей. ISID клиента, использующего TSP. Карточные платежи не могут быть осуществлены без этого параметра.
Покупатель не раскрывает свои карты и проходит верификацию 3-D Secure.
Yandex Pay
Информация о карте не должна быть введена для использования и заработной платы.
Для подключения метода оплаты Andex Pay обратитесь к своему менеджеру поддержки.
Как отправлять платеж
Пример оплаты с помощью данных из декодированного Yandex Pay-Token (Method Cloud_token)
Пример оплаты с помощью данных из расшифровки токена платежей от Yandex Pay (метод Pan_only)
При отправке платежа, формат платежей определяется способом аутентификации andex Pay:
- CLOUD_TOKEN. Без дополнительной аутентификации покупателя.Для отправки платежных данных в QIWI передайте в запросе API Платеж объект paymentMethod с параметрами:
type — всегда CARD;данные из расшифрованного платежного токена Yandex Pay:
PAN в поле «pan»;срок действия в формате MM/YY в поле «expiryDate»;объект external3dSec с элементами:
type — всегда YANDEX_PAY;cryptogram — содержимое поля cryptogram платежного токена Yandex Pay(Base64-закодированная строка);eciIndicator — ECI индикатор. Необходимо передавать, если поле eciIndicator получено в платежном токене Yandex Pay. В противном случае параметр не передавать. - type — всегда CARD;
- данные из расшифрованного платежного токена Yandex Pay:
PAN в поле «pan»;срок действия в формате MM/YY в поле «expiryDate»;объект external3dSec с элементами:
type — всегда YANDEX_PAY;cryptogram — содержимое поля cryptogram платежного токена Yandex Pay(Base64-закодированная строка);eciIndicator — ECI индикатор. Необходимо передавать, если поле eciIndicator получено в платежном токене Yandex Pay. В противном случае параметр не передавать. - PAN в поле «pan»;
- срок действия в формате MM/YY в поле «expiryDate»;
- объект external3dSec с элементами:
type — всегда YANDEX_PAY;cryptogram — содержимое поля cryptogram платежного токена Yandex Pay(Base64-закодированная строка);eciIndicator — ECI индикатор. Необходимо передавать, если поле eciIndicator получено в платежном токене Yandex Pay. В противном случае параметр не передавать. - type — всегда YANDEX_PAY;
- cryptogram — содержимое поля cryptogram платежного токена Yandex Pay(Base64-закодированная строка);
- eciIndicator — ECI индикатор. Необходимо передавать, если поле eciIndicator получено в платежном токене Yandex Pay. В противном случае параметр не передавать.
- PAN_ONLY. С дополнительной аутентификацией покупателя (3-D Secure).Для отправки платежных данных в QIWI передайте в запросе API Платеж объект paymentMethod с параметрами:
type — всегда CARD;данные из расшифрованного платежного токена Yandex Pay:
PAN в поле «pan»;срок действия в формате MM/YY в поле «expiryDate»;объект external3dSec с полем type, всегда равным YANDEX_PAY. - type — всегда CARD;
- данные из расшифрованного платежного токена Yandex Pay:
PAN в поле «pan»;срок действия в формате MM/YY в поле «expiryDate»;объект external3dSec с полем type, всегда равным YANDEX_PAY. - PAN в поле «pan»;
- срок действия в формате MM/YY в поле «expiryDate»;
- объект external3dSec с полем type, всегда равным YANDEX_PAY.
Оплата через СБП
Протокол приема платежей поддерживает списание средств покупателя через СБП. СБП позволяет осуществлять платежи в пользу юридических лиц с использованием R-кодов.
Квитанция об оплате SBP отключена по умолчанию. Для подключения этого способа оплаты обратитесь к менеджеру по поддержке.
Получение QR-кода
Иллюстрация запроса на платежные системы СБП
«Цветок для моей девушки»
Пример ответа на QR -код
«Цветок моему парню»
Чтобы покупатель мог заплатить через SBP, QR -код будет выставлен. Чтобы сделать это, вы должны отправить запрос в API, получить код QR SBP. В запросе вы должны указать:
- Объект qrCode с характеристиками запрашиваемого QR-кода:
Тип QR-кода в параметре qrCode.type:
DYNAMIC — динамический QR-код, индивидуальный для каждой оплаты.STATIC — статический QR-код, формируется один раз, удобно для товаров с фиксированной ценой.
Срок действия кода в минутах в параметре qrCode.ttl. Указывается только для qrCode.type=DYNAMIC. По умолчанию динамический QR-код активен в течение 72 часов, по истечении срока деактивируется.Тип и размер изображения QR-кода в блоке qrCode.image. - Тип QR-кода в параметре qrCode.type:
DYNAMIC — динамический QR-код, индивидуальный для каждой оплаты.STATIC — статический QR-код, формируется один раз, удобно для товаров с фиксированной ценой. - DYNAMIC — динамический QR-код, индивидуальный для каждой оплаты.
- STATIC — статический QR-код, формируется один раз, удобно для товаров с фиксированной ценой.
- Срок действия кода в минутах в параметре qrCode.ttl. Указывается только для qrCode.type=DYNAMIC. По умолчанию динамический QR-код активен в течение 72 часов, по истечении срока деактивируется.
- Тип и размер изображения QR-кода в блоке qrCode.image.
- Сумму платежа.
- Чтобы добавить описание платежа, используйте поле запроса paymentPurpose. Если это поле не заполнено, в приложении банка покупателя отобразится название вашего магазина.
Данные кода в ответе на вопрос содержатся в объекте qrCode.
- Image.content — QR-код, закодированный в base64. После декодирования вы получите изображение для демонстрации покупателю.
- Полезная нагрузка — QR на основе URL для перенаправления клиента на приложение банка.
Статус платежа через СБП
После оплаты оплата идет в окончательный статус.Текущий статус платежа с помощью идентификатора платежа может быть получен через API.
Статус QR-кода
Пример ответа на запрос статуса R-кода
Для моей девушки, букет
Вы можете использовать запрос Статус R-кода СБП. R-код возвращается в ответе. R-код показывает, действует ли он.
Выпуск токена для оплаты через СБП
Пример тела применения из выбросов токенов SBP
Вы можете выпустить токен платежа SBP, чтобы связать карту покупателя и последующие платежи через SBP.
Вы можете отправить запрос на получение R-кода СБП. в запросе укажите:
- Объект qrCode с характеристиками запрашиваемого QR-кода:
Тип QR-кода в параметре qrCode.type — TOKEN.Тип и размер изображения QR-кода в блоке qrCode.image. - Тип QR-кода в параметре qrCode.type — TOKEN.
- Тип и размер изображения QR-кода в блоке qrCode.image.
- Сумму платежа.
- Параметр tokenizationAccount — уникальный идентификатор Покупателя в системе ТСП.
- Описание токена в параметре tokenizationPurpose.
Необходимо использовать различные параметры токенизации для разных покупателей, чтобы гарантировать безопасность данных от прикрепленных карт клиентов.
Вы найдете подробную информацию о платежном токене SBP в объекте токена.
Оплата токеном через СБП
Примеры запросов
Для оплаты с помощью платежного токена SBP передайте API-платеж с токеном SBP:
- Платежный токен в параметре token,
- Идентификатор клиента, для которого был выпущен платежный токен в параметре tokenizationAccount.
Оплата со счета мобильного телефона
Выплаты мобильных телефонов производятся без ввода информации о кредитной карте. Покупатель получает сообщение SMS от своего мобильного оператора с информацией, связанной с платежей после начала оплаты.
Чтобы включить этот способ оплаты, пожалуйста, обратитесь к своему менеджеру.
Как отправлять платеж
При отправке платежа укажите параметры в блоке paymentMethod платежного запроса API:
- Тип — всегда MOBILE_COMMERCE.
- Телефон — номер телефона, с которого производится оплата. Число указывается в международном формате со знаком +.
Серверные уведомления
Сообщение Qiwi-это входящий пост-вызов с информацией об инциденте. Организация запроса содержит данные платежей/учетной записи, которые сериализованы в JSON (UTF-8 кодирование).
Протокол позволяет использовать следующие типы уведомлений о событиях API:
- PAYMENT — отправляется для платежных операций;
- CAPTURE — отправляется для операций подтверждения платежа;
- REFUND — отправляется для операций возврата платежа;
- CARD_CHEQUE — отправляется для операций проверки карты.
Адрес вашего сервера для обработки уведомлений указан в личной учетной записи, в разделе «Настройки».
Чтобы указать URL-сообщение отдельной операции, используйте:
- параметр callbackUrl — в запросах API Платеж, Подтверждение платежа, Операция возврата;
- параметр customFields.invoice_callback_url — в запросе API Создание счета.
Сертификат сайта должен быть выдан доверенным центром сертификации (например, Comodo, Verisign, Thawte и т.д.).
Для дополнительной уверенности необходимо принимать уведомления о платежах только с указанных ниже IP-адресов компании IWI:
- 79.142.16.0/20
- 195.189.100.0/22
- 91.232.230.0/23
- 91.213.51.0/24
Частота отправки уведомлений
Служба отправки ставит в очередь и распределяет уведомления о сбоях.
- 1 тест с задержкой в 5 секунд
- 1 тест с задержкой в 1 минуту
- 3 теста с задержкой 5 минут
Время маршрутизации может быть сдвинуто в большую сторону.
Формат уведомления PAYMENT
Подтверждение подтверждения полевой росписью. ObjecttyPetype системы TSP (200) Captureidican Идентификатор подтверждения. При создании Строки (200) CreedDatetimetatata используется URL-запись StrokaggD GM: SSSZAMOUNTINTION FOR Operations on the amount of operations идентификатор валюты операции (Alpha-3 ISO 4217 Code) Строка (200). Об этом пишет РБК. Номер телефона покупателя и пароль от него — строка URL-USA в системе TCPSTATION PLANS, или ее название на русском языке — «Objer», — предоставляются в качестве дополнительной информации о статусе операции ObjectValue. Карта VISA/MasterCard — единственный способ оплаты, принимаемый по умолчанию при совершении покупок. Для перевода денег используется специальное программное обеспечение или другие инструменты платежной системы со специальными свойствами Sale/Reversaltype.
Формат уведомления CHECK_CARD
Дается объяснение проверки TID «Метод оплаты» вместе с результатами проверки объектов ObjectcheckOperationDate и Stringstatus соответственно. MMA, SME или SMS «RequestUid» — это поля URL-адреса, о которых сообщает CNBC со ссылкой на данные группы Visa Incorpion в Twitter компании Spectrum Plus Evolution Soccer Golden Service. Возможные индикации: PASSED (3-D Secure завершен), NT_PASSIDE (3 DSECURE не прошел) или WITHOUT 3,2 MB/ML. Возможности для сравнения включают в себя методы строчной оплаты, систему удара по чаевым и другие. Последние версии были опубликованы в журнале «Forbets on Visa» 23 января 2020 года, а затем стали доступны на сайте Банка Индии с «датой отмены» 23 января 2021 года. Эти версии содержали информацию о том, когда был произведен платеж в сочетании с проверкой действительности карты, сообщает The Verge. трока латноо токена — то номер PAN, дл котороо л вдан тот сам оследни арол от аккаунта в системе и дата оконани срока дестви тоо арол ерва содерит идентиикатор окуател, укаанн риске вуске латн документов Stringtypeи уведомлениString(200)version ерси уведомлени.
Возвраты и отмены
Не все платежи имеют право на возмещение или отмены.
- Возврат средств возможен только для успешно завершенных платежных операций.
- Отмена возможна только в сценарии двухэтапного платежа и только для транзакций, которые еще не были подтверждены (CAPTURE).
I WI возвращает комиссию за платеж. Платеж был отменен в момент его возврата, в этом случае существует исключение. В этом случае комиссия не требуется.
Возвраты по оплаченным счетам
Используйте API-запрос, чтобы запросить возврат денег за оплаченный счет.
Возвраты по проведенным платежам
Только после успешных платежей возможен возврат инвестиций. Возможен либо частичный, либо полный возврат. Во втором сценарии вы получаете обратно всю сумму принятого платежа. В первом случае возвращается только часть платежа. Перед возвратом убедитесь, что платеж был успешно завершен и находится в статусе «Завершен».
Используйте модель транзакции API, чтобы отправить возврат метода транзакции API.
Используйте метод API, чтобы отправить возвратный возврат через SBP.
Сплитование платежей
Интерпретация платежей: решение, разработанное специально для мест на рынке, интерпретация платежей позволяет платить различным поставщикам услуг путем написания карты покупателя.
Свяжитесь с вашим сопровождающим менеджером и попросите решение для подключения для подключения расщепленных платежей.
Интеграция с Платежной формой QIWI
Для отправки платежа tka необходимо сделать запрос к API, который создает аккаунт Massionplits с данными о поставщиках.
Описание данных
Пример выставления счета со сплитом
curl —location —request PUT
—header
—header ‘Authorization: Bearer token
—data-raw ‘
:
: 3. 00,
:
,
: ,
: ,
:
: ,
: ,
:
: 2. 00,
:
,
: ,
:
,
: ,
: ,
:
: 1. 00,
:
,
: ,
:
Иллюстрация ответа с раздельным выставлением счетов
В каком массиве находится:
В объекте splits ответа содержатся сведения о сплитованных платежах и комиссиях:
Интеграция с Платежной формой мерчанта
Передайте JSON-Hardware с данными поставщиков в запросе API, чтобы отправить платеж с помощью ткачества.
Описание данных
« Товар из корзины»
Элементы массива paymentSplits:
Информация о принятых платежах и комиссиях содержится в объекте Payments Playmentsplits:
Возвраты по сплитованным платежам
Возврат средств за использование тканого платежа возможен после успешной авторизации списания средств.
« Товар из корзины»
«Продукт из кривой»
Отправьте файл REFUNDS MARRY JSON, содержащий информацию о возврате поставщиков в рамках запроса API DERFARTS. Укажите общую сумму возмещения, а также суммы отдельных поставщиков. Частичные или полные возмещения возможны в полных случаях.
Возврат очков:
База данных refundsplits включает информацию о принятых возмещениях:
Уведомления по сплитованным операциям
Пример уведомления по сплиту платежей
Пример уведомления по возврату сплитов платежей
Подобно тому, как отвечают на запросы API, уведомления о платежах и возврате написанных платежей:
- В часть сообщения типа PAYMENT добавляется массив JSON «paymentSplits», который используется для передачи платежных данных продавца. См. формат массива выше.
- В документ сообщения типа REFUND добавляется массив JSON с refundSplits. См. формат массива выше.
Платежный токен
Кошельки IWI и генерация токенов платежной карты поддерживаются протоколом принятия платежей. Они могут быть использованы для дополнительных дебств без введенной дополнительной информации о карте или номерах кошелька. Информация о платежной платежа карты хранится в зашифрованной форме при ее выдаче.
Особенности
Выпуск платежных токенов отключен по умолчанию. Вы должны связаться со своим сопровождающим менеджером, чтобы подключиться.