Принимать платежи через Монету можно несколькими способами:

• с помощью платёжной формы AssistantAPI (которая соответствует требованиям сертификации PCI DSS):
  • напрямую собрав ссылку и перенаправив на неё пользователя
  • через отправку HTML-формы
• через MerchantAPI

AssistantAPI (платёжная форма)

Для формирования запроса на оплату для платёжной формы достаточно указать два параметра:

• MNT_ID
• MNT_AMOUNT

Можно сформировать ссылку вручную и отправить её пользователю для оплаты, либо разместить HTML-форму на своём сайте.

Пример ссылки:

https://moneta.ru/assistant.widget?MNT_ID=НОМЕР_СЧЁТА&MNT_AMOUNT=СУММА_ПЛАТЕЖА

MerchantAPI

Для более гибкой настройки параметров платежа используйте протокол Moneta.MerchantAPI.

1. Создайте инвойс с необходимыми параметрами методом InvoiceRequest:

2. В ответе на создание инвойса в поле transaction находится номер созданной операции - перенаправьте покупателя на платёжную форму с помощью ссылки для оплаты указанной операции:

https://moneta.ru/assistant.widget?operationId=НОМЕР_СОЗДАННОЙ_ОПЕРАЦИИ

После успешного проведения операции Монета отправляет Уведомление об оплате в виде HTTP-запроса методом GET или POST на адрес, указанный в настройках расширенного счёта в поле “Pay URL” в личном кабинете на сайте moneta.ru.

payURL?
MNT_ID=11223344&MNT_TRANSACTION_ID=FF790ABCD&MNT_OPERATION_ID=123456&MNT_AMOUNT=120.25&
MNT_CURRENCY_CODE=RUB&MNT_TEST_MODE=0&MNT_SIGNATURE=69bdf9bd91820b8f7b4c4b25d3d22dfa

Получение уведомления нужно подтвердить ответом.

Ответ может быть в одном из форматов:

• Текстовый формат в кодировке UTF-8. Этот ответ не должен содержать HTML тэги. Возможные значения: SUCCESS, FAIL.
• Ответ в XML формате.

Текстовый ответ:

SUCCESS

Ответ в XML формате:

<?xml version="1.0" encoding="UTF-8"?>
<MNT_RESPONSE>
  <MNT_ID>11223344</MNT_ID>
  <MNT_TRANSACTION_ID>FF790ABCD</MNT_TRANSACTION_ID>
  <MNT_RESULT_CODE>200</MNT_RESULT_CODE>
  <MNT_SIGNATURE>29807c8e5d82198b5c4360e6ec711cce</MNT_SIGNATURE>
</MNT_RESPONSE>

MNT_SIGNATURE ответа на уведомление об оплате вычисляется следующим образом:

MNT_SIGNATURE = md5(20054600817FF790ABCDQWERTY)

где QWERTY – код проверки целостности данных.

Операция не будет переведена в статус “Выполнена”, если площадка не отправит ответ на уведомление об оплате, операция останется в статусе “Уведомление не отправлено”.

В течение 24 часов Система “МОНЕТА.РУ” будет направлять повторные уведомления.

Если в течение этого времени ни на одно из уведомлений площадка не ответит, Система “МОНЕТА.РУ” переведет операцию в статус “Выполнена”.

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

Отмена операции

Для удобства покупателей ТСП может использовать токен, который позволит покупателю не указывать номер карты при следующих платежах.

Такой токен можно создать двумя способами:

• с помощью параметра MNT_SUBSCRIBER_ID платёжной формы
• с помощью атрибута PAYMENTTOKEN в MerchantAPI

Эти способы взаимоисключающие и возможность их применения зависит от настроек счёта ТСП в ЛК Монеты. По-умолчанию доступен первый способ.

Через PAYMENTTOKEN

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

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

Оплата

1. Отправьте запрос на оплату методом PaymentRequest. При этом передайте следующие атрибуты операции:

• AUTHORIZEONLY со значением "1"
• PAYMENTTOKEN со значением "request"
• CARDNUMBER с номером карты покупателя
• CARDEXPIRATION со сроком действия карты покупателя
• CARDCVV2 с CVV-кодом карты покупателя

2. Из ответа сохраните атрибут paymenttoken - этот токен далее можно использовать вместо карточных данных, в том числе для рекуррентных платежей.

Отмена операции

Через MNT_SUBSCRIBER_ID

В данном сценарии используется query-параметр MNT_SUBSCRIBER_ID платёжной формы.

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

Холдирование

Отмена операции

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

Оплата

Отправьте запрос на оплату методом PaymentRequest. При этом в атрибутах операции передайте PAYMENTTOKEN со значением созданного ранее рекуррентного токена. Карточные данные передавать не нужно.