Payture API
MobilePay
https://{Environment}.payture.com/api/MobilePayМетод MobilePay используется для быстрого проведения клиентского платежа одним действием (одностадийный платеж) с помощью систем мобильных платежей Apple Pay, Google Pay, Samsung Pay.
Запрос
curl https://sandbox3.payture.com/api/MobilePay \
-X POST \
-H "Content-Type: application/x-www-form-urlencoded" \
-d Key=Merchant \
-d PayToken={PayToken} \
-d OrderId=5f63838d-fb03-00c6-c890-c67cfc1c54ea \
-d Checksum=true \
-d Amount=12480 \В запросах наименования параметров чувствительны к регистру
| Параметр | Описание | Формат |
|---|---|---|
| PayToken | Платежные данные: для Apple Pay — paymentData из PKPaymentToken в кодировке Base64 для Google Pay — token из paymentData в кодировке Base64 для Samsung Pay — paymentCredential в кодировке Base64 String Mandatory | String Mandatory |
| Key | Наименование платежного Терминала Предоставляется с параметрами тестового/рабочего доступа | String Mandatory |
| OrderId | Уникальный идентификатор платежа в системе Продавца Рекомендуемый формат: GUID/UUID или Alphanumeric. Другие форматы могут вызвать сбои в работе банковских сервисов. | String [1..50] Mandatory |
| Amount | Сумма платежа в копейках (или другая минимальная единица валюты терминала) Обязательный параметр для Google Pay. Amount должен совпадать с суммой в токене. Для Samsung Pay и Apple Pay используется только при «Checksum=True» (для Samsung Pay и Apple Pay сумма платежа используется из токена) | Integer Optional |
| SecureCode | CVV2/CVC2 код Параметр обязателен при оплате нетокенизированной картой через Google Pay | Integer Optional |
| CustomFields | Дополнительные поля транзакции Url Encoded строка, содержащая пары ключей и их значений, разделённые символом «;» (точка с запятой). Ключи и значения разделены символом «=» (равно) | String Optional |
| Checksum | Флаг, используемый для проверки совпадения сумм в токенах Apple Pay или Samsung Pay и параметре Amount с точностью до 100 копеек | Boolean Optional |
| Cheque | Информация о чеке в формате JSON, закодированная в Base64 | String Optional |
Ответ
Примеры ответов
<Pay OrderId="5f63838d-fb03-00c6-c890-c67cfc1c54ea" Key="Merchant" Success="True" Amount="12480"/>XML строка с элементом Pay
| Параметр | Описание | Формат |
|---|---|---|
| Success | Признак успешности операции. Принимает значения:True — операция успешнаFalse — операция неуспешна3DS — необходима аутентификация 3‑D Secure | String Mandatory |
| OrderId | Идентификатор платежа в системе Продавца Соответствует переданному в запросе | String [1..50] Mandatory |
| Key | Наименование платежного Терминала Соответствует переданному в запросе | String Mandatory |
| Amount | Сумма платежа в копейках (или другая минимальная единица валюты терминала) Передается, если «Success=True» или «Success=3DS» | Integer Optional |
| ACSUrl | Адрес сервера аутентификации 3-D Secure Передается, если «Success=3DS» | String Optional |
| PaReq | Запрос на аутентификацию 3-D Secure Передается, если «Success=3DS» | String Optional |
| ThreeDSKey | Уникальный идентификатор транзакции (MD) Передается, если «Success=3DS» | String Optional |
| ThreeDSVersion | Версия протокола 3-D Secure: 1.0 — первая версия 2.1 — вторая версия Передается, если «Success=3DS» | String Optional |
| FinalTerminal | Конечный Терминал, на котором был выполнен платеж Передается, если было перенаправление на другой Терминал | String Optional |
| AddInfo | Дополнительные параметры транзакции, которые могут быть переданы в ответе платежного шлюза по согласованию со службой поддержки Payture Описание формата и возможных параметров доступно здесь | Object Optional |
| ErrCode | Код ошибки. См. коды ошибок Передается, если «Success=False» | String Optional |
MobileBlock
https://{Environment}.payture.com/api/MobileBlockМетод MobileBlock позволяет блокировать денежные средства на карте Покупателя, добавленной в сервисах Apple Pay, Google Pay, Samsung Pay.
Запрос
curl https://sandbox3.payture.com/api/MobileBlock \
-X POST \
-H "Content-Type: application/x-www-form-urlencoded" \
-d Key=Merchant \
-d PayToken={PayToken} \
-d OrderId=5f63838d-fb03-00c6-c890-c67cfc1c54ea \
-d Checksum=true \
-d Amount=12480 \В запросах наименования параметров чувствительны к регистру
| Параметр | Описание | Формат |
|---|---|---|
| PayToken | Платежные данные: для Apple Pay — paymentData из PKPaymentToken в кодировке Base64 для Google Pay — token из paymentData в кодировке Base64 для Samsung Pay — paymentCredential в кодировке Base64 String Mandatory | String Mandatory |
| Key | Наименование платежного Терминала Предоставляется с параметрами тестового/рабочего доступа | String Mandatory |
| OrderId | Уникальный идентификатор платежа в системе Продавца Рекомендуемый формат: GUID/UUID или Alphanumeric. Другие форматы могут вызвать сбои в работе банковских сервисов. | String [1..50] Mandatory |
| Amount | Сумма платежа в копейках (или другая минимальная единица валюты терминала) Обязательный параметр для Google Pay. Amount должен совпадать с суммой в токене. Для Samsung Pay и Apple Pay используется только при «Checksum=True» (для Samsung Pay и Apple Pay сумма платежа используется из токена) | Integer Optional |
| SecureCode | CVV2/CVC2 код Параметр обязателен при оплате нетокенизированной картой через Google Pay | Integer Optional |
| CustomFields | Дополнительные поля транзакции Url Encoded строка, содержащая пары ключей и их значений, разделённые символом «;» (точка с запятой). Ключи и значения разделены символом «=» (равно) | String Optional |
| Checksum | Флаг, используемый для проверки совпадения сумм в токенах Apple Pay или Samsung Pay и параметре Amount с точностью до 100 копеек | Boolean Optional |
| Cheque | Информация о чеке в формате JSON, закодированная в Base64 | String Optional |
Ответ
Примеры ответов
<Block OrderId="5f63838d-fb03-00c6-c890-c67cfc1c54ea" Key="Merchant" Success="True" Amount="12480"/>XML строка с элементом Block
| Параметр | Описание | Формат |
|---|---|---|
| Success | Признак успешности операции. Принимает значения:True — операция успешнаFalse — операция неуспешна3DS — необходима аутентификация 3‑D Secure | String Mandatory |
| OrderId | Идентификатор платежа в системе Продавца Соответствует переданному в запросе | String [1..50] Mandatory |
| Key | Наименование платежного Терминала Соответствует переданному в запросе | String Mandatory |
| Amount | Сумма платежа в копейках (или другая минимальная единица валюты терминала) Передается, если «Success=True» или «Success=3DS» | Integer Optional |
| ACSUrl | Адрес сервера аутентификации 3-D Secure Передается, если «Success=3DS» | String Optional |
| PaReq | Запрос на аутентификацию 3-D Secure Передается, если «Success=3DS» | String Optional |
| ThreeDSKey | Уникальный идентификатор транзакции (MD) Передается, если «Success=3DS» | String Optional |
| ThreeDSVersion | Версия протокола 3-D Secure: 1.0 — первая версия 2.1 — вторая версия Передается, если «Success=3DS» | String Optional |
| FinalTerminal | Конечный Терминал, на котором был выполнен платеж Передается, если было перенаправление на другой Терминал | String Optional |
| AddInfo | Дополнительные параметры транзакции, которые могут быть переданы в ответе платежного шлюза по согласованию со службой поддержки Payture Описание формата и возможных параметров доступно здесь | Object Optional |
| ErrCode | Код ошибки. См. коды ошибок Передается, если «Success=False» | String Optional |
API
Программный интерфейс Payture позволяет клиентам оплачивать покупки в одно касание, используя карточные хранилища Apple Pay, Google Pay и Samsung Pay. Предоставляет Продавцу дополнительную возможность приема платежей…
Payture eWallet
Запрос vwapi/Pay c передачей PayToken используется для совершения платежа с использованием систем Apple Pay, Google Pay или Samsung Pay.
