Использование ApplePay, SamsungPay, GooglePay в приложении

Для работы с платежами в мобильных приложениях (или на сайте, но без перехода на страницу ввода реквизитов карты Банка) можно использовать расширенные параметры HTML-формы.

Перед отправкой POST-запроса необходимо сформировать платёжный токен в приложении или на сайте по инструкции соответствующей системы. Например, в случае ApplePay токен имеет вид:

{"paymentData":{"version":"EC_v1","data":"pNPWEDC/dZFILricVrdSrC7m0Jlm9gK8NL+IyLCWcycS0FHrdko7aqzv0=","signature":"MIAGCSqGSIb3DQEHAqCAMIACAQExDzANBglghkgBZQM=","header":{"ephemeralPublicKey":"MFkwEwYHKoZIzj0CAh06pYBPndn+drVGhAmfa/QCHBXE30ZReOGhSB2LV9ptGGjINM8PI5dU0IgXhVvcw==","publicKeyHash":"ghBdBZGQnem4v1MmmItug=","transactionId":"6022a5119e34aece05aae621e25f2b8390ba8e278786adeade21e874f66a8b31"}},"paymentMethod":{"displayName":"MasterCard 1281","network":"MasterCard","type":"debit"},"transactionIdentifier":"7133B4228F65BFDF25BBF733F36G399410CE9F389897BEFB0F32F985F66A8B32"}

{"paymentData":{"version":"EC_v1","data":"pNPWEDC/dZFILricVrdSrC7m0Jlm9gK8NL+IyLCWcycS0FHrdko7aqzv0=","signature":"MIAGCSqGSIb3DQEHAqCAMIACAQExDzANBglghkgBZQM=","header":{"ephemeralPublicKey":"MFkwEwYHKoZIzj0CAh06pYBPndn+drVGhAmfa/QCHBXE30ZReOGhSB2LV9ptGGjINM8PI5dU0IgXhVvcw==","publicKeyHash":"ghBdBZGQnem4v1MmmItug=","transactionId":"6022a5119e34aece05aae621e25f2b8390ba8e278786adeade21e874f66a8b31"}},"paymentMethod":{"displayName":"MasterCard 1281","network":"MasterCard","type":"debit"},"transactionIdentifier":"7133B4228F65BFDF25BBF733F36G399410CE9F389897BEFB0F32F985F66A8B32"}

Этот токен, а также признак, указывающий на конкретную платёжную систему, нужно отправить в дополнительных параметрах запроса к методу /create/:

	Параметр	Назначение	Обязательный
1	paytokentype	Система, одна из строк apple , google или samsung	Да
2	paytoken	Платёжный токен, JSON-строка	Да
3	json_errors	Вернуть ответ в виде JSON или сделать перенаправление на страницу результата или человеко-читаемое сообщение об ошибке? Строка yes или no , по умолчанию — no	Нет

Если json_errors = yes , то в результате запроса будет возвращён ответ в виде JSON.

В поле result будет "fail" , если во время исполнения запроса произошла какая-либо ошибка, либо "success" , и тогда в поле payment будет информация о попытке оплаты (возможно, неуспешной) в формате ответа на JSON API-запрос 2.1.

{
  "result":"success",
  "payment": {
    "id":"2000123",
    "pay_amount":"7072.98",
    "refund_amount":"0.00",
    "clientid":"testuser@example.com",
    "payment_system_id":"52",
    "site_description":"ВТБ",
    "system_description":"VTB",
    "unique_id":"2403842",
    "status":"success",
    "repeat_counter":"0",
    "pending_datetime":"2019-02-15 10:20:47",
    "obtain_datetime":"2019-02-15 10:21:03",
    "success_datetime":"2019-02-15 10:21:07"
  }
}

{

"result":"success",

"payment": {

"id":"2000123",

"pay_amount":"7072.98",

"refund_amount":"0.00",

"clientid":"testuser@example.com",

"payment_system_id":"52",

"site_description":"ВТБ",

"system_description":"VTB",

"unique_id":"2403842",

"status":"success",

"repeat_counter":"0",

"pending_datetime":"2019-02-15 10:20:47",

"obtain_datetime":"2019-02-15 10:21:03",

"success_datetime":"2019-02-15 10:21:07"

}

В случае ошибки будет возвращено:

{
  "result":"fail",
  "message":"processing gateway returned error status",
  "error_code":71
}

{

"result":"fail",

"message":"processing gateway returned error status",

"error_code":71

}

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

Если параметр json_errors не был передан или передан как no , вместо JSON-строки сервером будет отправлен HTTP-статус HTTP/1.1 302 Found с заголовком Location: , указывающим на человеко-читаемую страницу результата платежа или сообщения об ошибке

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

Если требуется реализовать одновременно все три возможных сценария работы с токенизированными оплатами: кнопка оплаты на странице ввода реквизитов, веб-покупка (кнопка на сайте) и in-app покупка (оплата в приложении без перехода из приложения), нужно будет работать с тремя личными кабинетами.