Запрос регистрации заказа (REST)

Для регистрации заказа используется запрос register.do (см. раздел Координаты подключения).

Параметры запроса:

* По умолчанию в процессинг банка передаются поля:

• •

  orderNumber — номер заказа в системе магазина;

• •

  description — описание заказа (не более 99 символов, запрещены к использованию %, +, конец строки \r и перенос строки \n).

Параметры ответа:

Коды ошибок (поле errorCode**):**

Пример запроса POST:

amount=100&currency=810&language=ru&orderNumber=87654321&returnUrl=http://yoursite.com&pageView=DESKTOP&jsonParams={"param1":"value1","param2":"value2"}&expirationDate=2014-09-08T14:14:14&merchantLogin=merch_child&features=AUTO_PAYMENT

Пример ответа:

{"orderId":"70906e55-7114-41d6-8332-4609dc6590f4","formUrl":"https://server/application_context//merchants/test/payment_ru.html?mdOrder=70906e55-7114-41d6-8332-4609dc6590f4″}

Запрос регистрации заказа с предавторизацией (REST)

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

Параметры запроса:

{"<name1>":"<value1>",...,"<nameN>":"<valueN>"}

По умолчанию в процессинг банка передаются поля:

• •

  orderNumber — номер заказа в системе магазина;

• •

  description — описание заказа (не более 99символов, запрещены к использованию %, +, конец строки \r и перенос строки \n).

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

Параметры ответа:

Коды ошибок (поле errorCode):

Пример запроса GET:

https://alfa.rbsuat.com/payment/rest/registerPreAuth.do?amount=100¤cy=810&language=ru&orderNumber=87654321&password=password&returnUrl=https://alfa.rbsuat.com/payment/finish.html&userName=userName&{jsonParams="param1»:"value1»,"param2»:"value2"}&pageView=MOBILE&merchantLogin=merch_child

Пример запроса POST:

amount=100&currency=810&language=ru&orderNumber=87654321&returnUrl=https://alfa.rbsuat.com/payment/finish.html&pageView=MOBILE&{jsonParams="param1»:"value1»,"param2»:"value2"}&merchantLogin=merch_child

Пример ответа:

{"orderId»:"61351fbd-ac25-484f-b930-4d0ce4101ab7»,"formUrl»:"https://alfa.rbsuat.com/payment/merchants/test/mobile_payment_ru.html?mdOrder=61351fbd-ac25-484f-b930-4d0ce4101ab7«}

Запрос отмены незавершенного заказа (REST)

Для отмены незавершённого заказа используется запрос decline.do. После успешного выполнения этого запроса заказ переводится в состояние Отменён.

Запрос завершения оплаты заказа (REST)

Для запроса завершения ранее предавторизованного заказа используется запрос deposit.do (см. раздел Координаты подключения).
Данную операцию можно осуществлять, если есть соответствующие права в системе.

Параметры запроса:

Параметры ответа:

Коды ошибок (поле errorCode): Классификация:

Расшифровка:

Пример запроса GET:

https://alfa.rbsuat.com/payment/rest/deposit.do?amount=100&currency=810&language=ru&orderId=e5b59d3d-746b-4828-9da4-06f126e01b68&password=password&userName=userName

Пример запроса POST:

amount=100&currency=810&language=ru&orderId=e5b59d3d-746b-4828-9da4-06f126e01b68

Пример ответа:

{"errorCode»: 0}

Запрос состояния заказа (REST)

Для получения текущего состояния заказа используется запрос getOrderStatus.do (см. раздел Координаты подключения). Статус заказа необходимо определять по значению параметра OrderStatus. Поле authCode является устаревшим.

Параметры запроса:

Параметры ответа:

Поле OrderStatus может принимать следующие значения:

Коды ошибок (поле ErrorCode):

Пример запроса GET:

https://alfa.rbsuat.com/payment/rest/getOrderStatus.do?orderId=b8d70aa7-bfb3-4f94-b7bb-aec7273e1fce&language=ru&userName=userName&password=password

Пример запроса POST:

orderId=b8d70aa7-bfb3-4f94-b7bb-aec7273e1fce&language=ru

Пример ответа:

{"expiration»:"201512»,"cardholderName»:"tr tr»,"depositAmount»: 789789,"currency»:"810»,"approvalCode»:"123456»,"authCode»: 2,"clientId»:"666»,"bindingId»:"07a90a5d-cc60-4d1b-a9e6-ffd15974a74f»,"ErrorCode»:"0»,"ErrorMessage»:"Успешно»,"OrderStatus»: 2,"OrderNumber»:"23asdafaf»,"Pan»:"411111**1111»,"Amount»: 789789}

Расширенный запрос состояния заказа (REST)

Для запроса состояния зарегистрированного заказа используется запрос getOrderStatusExtended.do.

Параметры запроса:

*В запросе должен присутствовать либо orderId, либо orderNumber. Если в запросе присутствуют оба параметра, то приоритетным считается orderId.

Существует несколько наборов параметров ответа. Какие именно наборы параметров будут возвращены, зависит от версии getOrderStatusExtended, указанной в настройках продавца.

Элемент merchantOrderParams — присутствует в ответе, если в заказе содержатся дополнительные параметры продавца. Каждый дополнительный параметр заказа представлен в отдельном элементе merchantOrderParams.

Элемент attributes включает в себя следующие параметры:

Элемент cardAuthInfo — в элементе лежит структура, состоящая из списка элемента secureAuthInfo и следующих параметров:

Элемент payerData состоит из параметров.

Элемент secureAuthInfo.

Элемент bindingInfo состоит из параметров:

Блок pluginInfo (представляющий собой JSON object) — присутствует в ответе, если оплата шла через payment plugin (платёжный плагин) и для конкретного платёжного метода требуется отображение какой-либо информации в getOrderStatusExtended (для продавца должна быть включена настройка payment.plugins.enabled). Состоит из параметров:

Элемент paymentAmountInfo состоит из параметров:

Элемент bankInfo состоит из параметров:

Блок refunds содержит информацию по возвратам. Добавляется в ответ на запрос getOrderStatusExtended 05 версии и выше и присутствует только, если есть возврат по заказу.

Параметры блока следующие:

Элемент transactionAttributes — присутствует в ответе, если в заказе содержатся дополнительные параметры транзакции.

Содержимое orderBundle

Содержимое ofdOrderBundle

Блок доступен с 24 версии getOrderStatusExtended.

Элемент ofdOrderBundle состоит из параметров:

Содержимое customerDetails

Содержимое cartItems

Ниже представлены параметры блока cartItems

Содержимое deliveryInfo

Содержимое items

Содержимое quantity

Ниже представлены параметры блока quantity

Содержимое itemDetails

Содержимое discount

Содержимое agentInterest

Содержимое tax

Ниже представлены параметры блока tax.

Содержимое itemAttributes

Блок itemAttributes содержит блок attributes, включающий следующие параметры:

Атрибуты заказа в платёжной системе (номер заказа).

Пример запроса POST:

orderId=b9054496-c65a-4975-9418-1051d101f1b9&language=ru&merchantOrderNumber=0784sse49d0s134567890

Пример ответа:

{"errorCode":"0","errorMessage":"Успешно","orderNumber":"0784sse49d0s134567890","orderStatus":6,"actionCode":-2007,
"actionCodeDescription":"Время сессии истекло","amount":33000,"currency":"810",
"date":1383819429914,
"orderDescription":" ","merchantOrderParams":[{"name":"email","value":"yap"}],"attributes":[{"name":"mdOrder",
"value":"b9054496-c65a-4975-9418-1051d101f1b9"}],"cardAuthInfo":{"expiration":"201912",
"cardholderName":"Ivan","secureAuthInfo": {"eci":6,"threeDSInfo": {"xid":"MDAwMDAwMDEzODM4MTk0MzAzMjM="}},
"pan":"411111**1111"},"terminalId":"333333"}

Пример ответа на запрос getOrderStatusExtended с 3DS 2:

1{
2  "errorCode": "0",
3  "errorMessage": "Success",
4  "orderNumber": "87520",
5  "orderStatus": 2,
6  "actionCode": 0,
7  "actionCodeDescription": "",
8  "amount": 10000,
9  "currency": "978",
10  "date": 1681676561910,
11  "depositedDate": 1681676563641,
12  "orderDescription": "",
13  "ip": "10.99.50.51",
14  "merchantOrderParams": [
15    {
16      "name": "browser_language_param",
17      "value": "en"
18    }, 
19    {
20      "name": "browser_os_param",
21      "value": "UNKNOWN"
22    }, 
23    {
24      "name": "browser_name_param",
25      "value": "DOWNLOAD"
26    }, 
27    {
28        "name": "user_agent",
29        "value": "Apache-HttpClient/4.5.12 (Java/11.0.18)"
30    }
31  ],
32  "transactionAttributes": [
33    {
34      "name": "cvcExist",
35      "value": "true"
36    }, 
37    {
38      "name": "merchantIp",
39      "value": "10.99.50.51"
40    }, 
41    {
42      "name": "tii",
43      "value": "CI"
44    }, 
45    {
46      "name": "paymentNetRefNum",
47      "value": "MCA015913"
48    }
49  ],
50  "attributes": [
51    {
52      "name": "mdOrder",
53      "value": "b820f801-e98e-7d82-be15-a5a608873a40"
54    }
55  ],
56  "cardAuthInfo": {
57    "maskedPan": "525899**0075",
58    "expiration": "202412",
59    "cardholderName": "Integration Tester",
60    "approvalCode": "232243",
61    "paymentSystem": "MASTERCARD",
62    "secureAuthInfo": {
63      "eci": 2,
64      "threeDSInfo": {
65        "xid": "9cff1833-95fb-42b1-90c5-f8563d11bf88",
66        "cavv": "kBMSeAAAHnoTYhRQktfpAWQxx3Zg"
67      },
68      "authTypeIndicator": 3,
69      "threeDsProtocolVersion": "2.1.0",
70      "rreqTransStatus": "Y",
71      "aresTransStatus": "C"
72    },
73    "pan": "525899**0075"
74  },
75  "bindingInfo": {
76    "clientId": "d96b40c4-2d69-4709-9944-a5622b86da57",
77    "bindingId": "0f15c7e3-9a4e-7696-8dc7-160708873a40"
78  },
79  "authDateTime": 1681676563580,
80  "terminalId": "22222222",
81  "authRefNum": "310689170161",
82  "paymentAmountInfo": {
83    "paymentState": "DEPOSITED",
84    "approvedAmount": 10000,
85    "depositedAmount": 10000,
86    "refundedAmount": 0,
87    "feeAmount": 0,
88    "totalAmount": 10000
89  },
90  "bankInfo": {
91    "bankCountryCode": "UNKNOWN",
92    "bankCountryName": "<Unknown>"
93  },
94  "chargeback": false,
95  "paymentWay": "CARD"
96}

Запрос отмены оплаты заказа (REST)

Для отмены оплаты заказа используется запрос reverse.do (см. раздел Координаты подключения).
Функция отмены доступна в течение ограниченного времени после оплаты, точные сроки необходимо уточнять в Банке.
Операция отмены оплаты может быть совершена только один раз. Если она закончится ошибкой, то повторная операция отмены платежа не пройдёт.
Данная функция доступна магазинам по согласованию с Банком. Для выполнения операции отмены пользователь должен обладать соответствующими правами.

Параметры запроса:

Параметры ответа:

Коды ошибок (поле ErrorCode):

Классификация:

Расшифровка:

Пример запроса GET:

https://alfa.rbsuat.com/payment/rest/reverse.do?language=ru&orderId=9231a838-ac68-4a3e-bddb-d9781433d852&password=password&userName=userName

Пример запроса POST:

language=ru&orderId=9231a838-ac68-4a3e-bddb-d9781433d852

Пример ответа:

{"errorCode»:"0»,"errorMessage»:"Успешно"}

Запрос возврата средств оплаты заказа (REST)

Для возврата средств используется запрос refund.do.

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

Для выполнения операции возврата необходимо наличие соответствующих права в системе.

Параметры запроса:

Параметры ответа:

Коды ошибок (поле errorCode):

Расшифровка:

Запрос проверки вовлечённости карты в 3DS (REST)

Для проверки вовлечённости карты в 3DSиспользуется запрос verifyEnrollment.do (см. раздел Координаты подключения).

Параметры запроса:

Параметры ответа:

Коды ошибок (поле errorCode):

Пример запроса GET:

https://alfa.rbsuat.com/payment/rest/verifyEnrollment.do?userName=userName&password=password&pan=4111111111111111

Пример запроса POST:

pan=4111111111111111

Пример ответа:

{"errorCode»:"0»,"errorMessage»:"Успешно»,"emitterName»:"TEST CARD»,"emitterCountryCode»:"RU»,"enrolled»:"Y"}

Запрос добавления дополнительных параметров к заказу (REST)

Для добавления к заказу новых дополнительных параметров используется запрос addParams.do (см. раздел Координаты подключения).
Если в заказе уже существует дополнительный параметр, то при добавлении параметра с тем же именемв заказе сохранится последнее переданное значение.

Параметры запроса:

Параметры ответа

Коды ошибок (поле ErrorCode):

Пример запроса GET:

https://alfa.rbsuat.com/payment/rest/addParams.do?language=ru&orderId=769b8dad-2318-4c01-bfc4-94532522fa68&password=password&userName=userName&params={"addParams1»:"value1»,"addParams2»:"value2"}

Пример запроса POST:

language=ru&orderId=769b8dad-2318-4c01-bfc4-94532522fa68&params={"addParams1»:"value1»,"addParams2»:"value2"}

Пример ответа:

{"errorCode»: 0}

Запрос статистики по платежам за период (REST)

Для получения статистики по платежам за определённый период используется запрос getLastOrdersForMerchants.do (см. раздел Координаты подключения).

Параметры запроса:

Параметры ответа:

Параметры блока orderStatuses:

Параметры блока merchantOrderParams:

Параметры блока attributes:

Параметры блока bindingInfo:

Параметры блока paymentAmountInfo:

Параметры блока bankInfo:

Поле orderStatus может принимать следующие значения:

Коды ошибок (поле errorCode):

Пример запроса GET:

https://alfa.rbsuat.com/payment/rest/getLastOrdersForMerchants.do?userName=userName&password=password&language=ru&page=0&size=100&from=20141009160000&to=20141111000000&transactionStates=DEPOSITED,REVERSED&merchants=SevenEightNine&searchByCreatedDate=false

Пример запроса POST:

language=ru&page=0&size=100&from=20141009160000&to=20141111000000&transactionStates=DEPOSITED, REVERSED&merchants=SevenEightNine&searchByCreatedDate=false

Пример ответа:

{"errorCode»: 0,

«orderStatuses»: [

{"errorCode»:"0»,"orderNumber»:"58drs0Pes459Hdsddd0567a0»,"orderStatus»: 2,"actionCode»: 0,"actionCodeDescription»:"Запрос успешно обработан»,"amount»: 250000,"currency»:"810»,"date»: 1414485649233,"orderDescription»:"Opisanie»,"ip»:"212.5.125.194»,"merchantOrderParams»: [{"name»:"registr1»,"value»:"registr1"}],"attributes»: [{"name»:"mdOrder»,"value»:"f1a3365b-542c-4c8d-b34c-e9a7ee8dbc9c"}],"cardAuthInfo»: {"expiration»:"201512»,"cardholderName»:"Ivan»,"approvalCode»:"123456»,"pan»:"411111**1111"},"bindingInfo»: {"clientId»:"666»,"bindingId»:"1eabfb8e-b90e-4dc8-bef6-14bd392b1cec"},"authDateTime»: 1414485661207,"terminalId»:"111113»,"authRefNum»:"111111111111»,"paymentAmountInfo»: {"paymentState»:"DEPOSITED»,"approvedAmount»: 250000,"depositedAmount»: 250000,"refundedAmount»: 0},"bankInfo»: {"bankName»:"TEST CARD»,"bankCountryCode»:"RU»,"bankCountryName»:"Россия"}},

{"errorCode»:"0»,"orderNumber»:"57drs0Pes459Hdsddd0567a0»,"orderStatus»: 2,"actionCode»: 0,"actionCodeDescription»:"Запрос успешно обработан»,"amount»: 250000,"currency»:"810»,"date»: 1414485277286,"orderDescription»:"Opisanie»,"ip»:"212.5.125.194»,"merchantOrderParams»: [{"name»:"registr1»,"value»:"registr1"}],"attributes»: [{"name»:"mdOrder»,"value»:"09489184-bc5e-44a7-b6c4-3ca1feb8ef69"}],"cardAuthInfo»: {"expiration»:"201512»,"cardholderName»:"Ivan»,"approvalCode»:"123456»,"pan»:"411111**1111"},"bindingInfo»: {"clientId»:"666»,"bindingId»:"1eabfb8e-b90e-4dc8-bef6-14bd392b1cec"},"authDateTime»: 1414485296046,"terminalId»:"111113»,"authRefNum»:"111111111111»,"paymentAmountInfo»: {"paymentState»:"DEPOSITED»,"approvedAmount»: 250000,"depositedAmount»: 250000,"refundedAmount»: 0},"bankInfo»: {"bankName»:"TEST CARD»,"bankCountryCode»:"RU»,"bankCountryName»:"Россия"}}],

«totalCount»: 2,"page»: 0,"pageSize»: 100}

Запрос оплаты через внешнюю платёжную систему (REST)

Для оплаты заказа через внешнюю платёжную систему используется запрос paymentotherway.do (см. раздел Координаты подключения) со специальными параметрами. Возможен только запрос POST. Данная операция доступна при наличии соответствующих прав в системе.

Параметры запроса:

Параметры ответа:

Коды ошибок (поле errorCode):

Пример запроса POST:

language=ru&MDORDER=c96a734c-e2c9-429c-8fda-aaa0030c8a92&paymentWay=ALFA_ALFACLICK

Пример ответа:

{"redirect»:"http://testjmb.alfabank.ru/PayByClick/login.jsp?orderId=b37da970-e2b8-4729-a196-b4c2ab5bb401&backUrl=+»,"info»:"Your
 order is proceeded, redirecting…»,"errorCode»: 0}

Запрос проведения платежа по связке (REST)

Для проведения платежа по связкам используется запрос paymentOrderBinding.do (см. раздел Координаты подключения).

Параметры запроса:

Параметры ответа:

Коды ошибок (поле success):

Пример запроса POST:

mdOrder=eb49300c-95b7-4dcd-9739-eee6c61f2ac4&bindingId=308042e8-2b28-484a-811e-f786c9776c3b&cvc=123

Пример успешного ответа при SSL-платеже:

{"redirect»:"http://ya.ru?orderId=eb49300c-95b7-4dcd-9739-eee6c61f2ac4»,"info»:"Ваш платёж обработан, происходит переадресация…»,"errorCode»: 0}

Пример успешного ответа при 3DS-платеже:

{"info»:"Ваш платёж обработан, происходит переадресация…»,"acsUrl»:"https://alfa.rbsuat.com/payment/acs/auth/start.do»,"paReq»:"eJxVUdtugkAQ/RXCOy7LRdQMa2ixKU28pGrfyTICqSzKpcW/765AbR8mOWcyOWfmDCy74qx9YVXn\npfB1OjF1DQUvk1ykvn48vBgzfcngkFWI4R55WyGDNdZ1nKKWJ74+TVz05tPE8NyZbThOfDJmFjcN\ni55Mz+MJzu25zmAXvOOVwWDEpM/EAjJSqVjxLBYNg5hfn6INcyxvappABgoFVlHIPCA9ABEXyPb4\nhWKVp1mzyQUCuTeBl61oqhubOjaQkUBbnVnWNJcFId5sPuFlAUT1gDy8d61CtdTo8oStw+C7r5W5\nCVNZx9v6ENmyfCBqApK4QWaZ1KXUcjVqLVx7Ycu77n2IC2XOqDqjh3BRDsGj/5eDDLeS2Y+bjwyw\nu5QC5YRU/sVAHts+v6rceCODyfbb7m3bfmzD22dnlycaFHF+DGl0y6hK8z6kFHMZity7l1QEiJIh\nw6PI8GOJ/v3+BweMtyE=»,"termUrl»:"https://web.rbsuat.com/:443/ab/rest/finish3ds.do»,"errorCode»: 0}

Пример ответа с ошибкой:

{"error»:"Access denied»,"errorCode»: 5,"errorMessage»:"Access denied"}

Запрос деактивации связки (REST)

Для того чтобы сделать существующую связку неактивной используется запрос unBindCard.do (см. раздел Координаты подключения).

Параметры запроса:

Параметры ответа:

Коды ошибок (поле errorCode):

Пример запроса GET:

https://alfa.rbsuat.com/payment/rest/unBindCard.do?userName=userName&password=password&bindingId=fd3afc57-c6d0-4e08-aaef-1b7cfeb093dc

Пример запроса POST:

bindingId=fd3afc57-c6d0-4e08-aaef-1b7cfeb093dc

Пример ответа:

{"errorCode»:"2»,"errorMessage»:"Binging isn't active"}

Запрос активации связки (REST)

Для активации деактивированной ранее связки используется запрос bindCard.do (см. раздел Координаты подключения).

Параметры запроса:

Параметры ответа:

Коды ошибок (поле errorCode):

Пример запроса GET:

https://alfa.rbsuat.com/payment/rest/bindCard.do?userName=userName&password=password&bindingId=fd3afc57-c6d0-4e08-aaef-1b7cfeb093dc

Пример запроса POST:

bindingId=fd3afc57-c6d0-4e08-aaef-1b7cfeb093dc

Пример ответа:

{"errorCode»:"2»,"errorMessage»:"Binding is active"}

Запрос изменения срока действия связки (REST)

Для продления срока действия связки используется запрос extendBinding.do (см. раздел Координаты подключения).

Параметры запроса:

Параметры ответа:

Коды ошибок (поле errorCode):

Пример запроса GET:

https://alfa.rbsuat.com/payment/rest/extendBinding.do?userName=userName&password=password&bindingId=1eabfb8e-b90e-4dc8-bef6-14bd392b1cec&newExpiry=201612&language=ru

Пример запроса POST:

bindingId=1eabfb8e-b90e-4dc8-bef6-14bd392b1cec&newExpiry=201612&language=ru

Пример ответа:

{"errorCode»:"0»,"errorMessage»:"Успешно"}

Запрос списка связок клиента (REST)

Для получения списка связок по идентификатору клиента используется запрос getBindings.do (см. раздел Координаты подключения).

Параметры запроса:

Параметры ответа:

Элемент binding (состоит из bindingId, maskedPan и expiryDate):

Коды ошибок (поле errorCode):

Пример запроса GET:

https://alfa.rbsuat.com/payment/rest/getBindings.do?userName=userName&password=password&clientId=client

Пример запроса POST:

clientId=client

Пример ответа:

{"bindings»: [{"bindingId»:"fd3afc57-c6d0-4e08-aaef-1b7cfeb093dc»,"maskedPan»:"4000 00** **** **02»,"expiryDate»:"201512"}],"errorCode»:"0»,"errorMessage»:"Успешно"}

Запрос списка связок банковской карты (REST)

Для получения списка связок банковской карты используется метод getBindingsByCardOrId.do (см. раздел Координаты подключения).
При наличии соответствующих разрешений магазин может запросить список всех связок, относящихся к определённой банковской карте. Сделать это можно по номеру карты или по известному идентификатору связки.При наличии соответствующих разрешений магазин может запросить список всех связок, относящихся к определённой банковской карте. Сделать это можно по номеру карты или по известному идентификатору связки.
В ответе возвращаются все связки, доступные мерчанту в соответствии с его настройками.

Параметры запроса:

Параметры ответа:

Элемент bindings (содержит блоки, состоящие из параметров bindingId, maskedPan, expiryDate и clientId):

Коды ошибок (поле errorCode):

Пример запроса:

https://alfa.rbsuat.com/payment/rest/getBindingsByCardOrId.do?userName=login&password=password&pan=4111111111111111

Параметры ответа:

{"errorCode»:"0»,"errorMessage»:"Успешно»,"bindings»: [{"bindingId»:"0b8edeb2-8380-4092-bf7e-1e1a78f2b15e»,"maskedP
an»:"411111**1111»,"expiryDate»:"201912»,"clientId»:"12"}, {"bindingId»:"6a8c0738-cc88-4200-acf6-afc264d66cb0»,"mas
kedPan»:"411111**1111»,"expiryDate»:"201912»,"clientId»:"666"}, {"bindingId»:"97a70989-c1fb-49f7-8a42-27c19dc160dw»
,"maskedPan»:"411111**1111»,"expiryDate»:"201512»,"clientId»:"666"}]}

Запрос на оплату через Apple Pay (REST)

Для регистрации заказа используется запрос payment.do (см. раздел Координаты подключения).

Пример запроса POST

{"merchant»:"merchant_name»,"orderNumber»:"applepay123456794»,"description»:"descritpion_text», «paymentToken»:"eyJ2ZXJzaW9uIjoiRUNfdjEiLCJkYXRhIjoiNTFhUTNGOXl0Q1YwYTdpQS9mMUh0RGc1TnBvSVZtc2RFa1FvTlpoOW95ZVA3eGgvVDk4dXJkenJDN0dOQ3o4c1FodXpXOVZNWUhGU25DTytTWXo0eDYrTnZwZjdCUzhOcnlUWk1Keldtcml0VUZJVytwVjNvNWY4M0F3OU55c1BCMlAxZGZicS9hZDVzV1RwZTMwTnV2UDltRGhaUStET1M3RzB6MDZSNHRXY0R0VFErT0U5YlI1OHFQRUdnTTRiSmRmUklZb25oQlJrdWY2cGw4aU9PQ0VvS01QN2lRck84Z2IrVGNnSjVZSDdDL3J3enBDUVZjMGQxNWJuME9wbE1SOGwxMDcrMDR4ZVVWT3BUMGI3cHRmYnA3VmVaeHVXaHhSTTlHYlF5QmVkVlJHQ2toN3kyREtZY3BRdjJqM1h2L0NjNzRKaVBZM09DTFVEMEIvS0UwUFo1TnJvUEJFUmZ2a1B4WUFzV1ZmM1E3UUtTcTk4Z3p5UXlrWEpwTmFwcEt6cENDMkNKU09XdzVkenNPWjAiLCAic2lnbmF0dXJlIjoiTUlBR0NTcUdTSWIzRFFFSEFxQ0FNSUFDQVFFeER6QU5CZ2xnaGtnQlpRTUVBZ0VGQURDQUJna3Foa2lHOXcwQkJ3RUFBS0NBTUlJRDVqQ0NBNHVnQXdJQkFnSUlhR0QybWRuTXB3OHdDZ1lJS29aSXpqMEVBd0l3ZWpFdU1Dd0dBMVVFQXd3bFFYQndiR1VnUVhCd2JHbGpZWFJwYjI0Z1NXNTBaV2R5WVhScGIyNGdRMEVnTFNCSE16RW1NQ1FHQTFVRUN3d2RRWEJ3YkdVZ1EyVnlkR2xtYVdOaGRHbHZiaUJCZFhSb2IzSnBkSGt4RXpBUkJnTlZCQW9NQ2tGd2NHeGxJRWx1WXk0eEN6QUpCZ05WQkFZVEFsVlRNQjRYRFRFMk1EWXdNekU0TVRZME1Gb1hEVEl4TURZd01qRTRNVFkwTUZvd1lqRW9NQ1lHQTFVRUF3d2ZaV05qTFhOdGNDMWljbTlyWlhJdGMybG5ibDlWUXpRdFUwRk9SRUpQV0RFVU1CSUdBMVVFQ3d3TGFVOVRJRk41YzNSbGJYTXhFekFSQmdOVkJBb01Da0Z3Y0d4bElFbHVZeTR4Q3pBSkJnTlZCQVlUQWxWVE1Ga3dFd1lIS29aSXpqMENBUVlJS29aSXpqMERBUWNEUWdBRWdqRDlxOE9jOTE0Z0xGRFptMFVTNWpmaXFRSGRiTFBnc2MxTFVtZVkrTTlPdmVnYUphakNIa3d6M2M2T0twYkM5cStoa3dORnhPaDZSQ2JPbFJzU2xhT0NBaEV3Z2dJTk1FVUdDQ3NHQVFVRkJ3RUJCRGt3TnpBMUJnZ3JCZ0VGQlFjd0FZWXBhSFIwY0RvdkwyOWpjM0F1WVhCd2JHVXVZMjl0TDI5amMzQXdOQzFoY0hCc1pXRnBZMkV6TURJd0hRWURWUjBPQkJZRUZBSWtNQXVhN3UxR01aZWtwbG9wbmtKeGdoeEZNQXdHQTFVZEV3RUIvd1FDTUFBd0h3WURWUjBqQkJnd0ZvQVVJL0pKeEUrVDVPOG41c1QyS0d3L29ydjlMa3N3Z2dFZEJnTlZIU0FFZ2dFVU1JSUJFRENDQVF3R0NTcUdTSWIzWTJRRkFUQ0IvakNCd3dZSUt3WUJCUVVIQWdJd2diWU1nYk5TWld4cFlXNWpaU0J2YmlCMGFHbHpJR05sY25ScFptbGpZWFJsSUdKNUlHRnVlU0J3WVhKMGVTQmhjM04xYldWeklHRmpZMlZ3ZEdGdVkyVWdiMllnZEdobElIUm9aVzRnWVhCd2JHbGpZV0pzWlNCemRHRnVaR0Z5WkNCMFpYSnRjeUJoYm1RZ1kyOXVaR2wwYVc5dWN5QnZaaUIxYzJVc0lHTmxjblJwWm1sallYUmxJSEJ2YkdsamVTQmhibVFnWTJWeWRHbG1hV05oZEdsdmJpQndjbUZqZEdsalpTQnpkR0YwWlcxbGJuUnpMakEyQmdnckJnRUZCUWNDQVJZcWFIUjBjRG92TDNkM2R5NWhjSEJzWlM1amIyMHZZMlZ5ZEdsbWFXTmhkR1ZoZFhSb2IzSnBkSGt2TURRR0ExVWRId1F0TUNzd0thQW5vQ1dHSTJoMGRIQTZMeTlqY213dVlYQndiR1V1WTI5dEwyRndjR3hsWVdsallUTXVZM0pzTUE0R0ExVWREd0VCL3dRRUF3SUhnREFQQmdrcWhraUc5Mk5rQmgwRUFnVUFNQW9HQ0NxR1NNNDlCQU1DQTBrQU1FWUNJUURhSEdPdWkrWDJUNDRSNkdWcE43bTJuRWNyNlQ2c01qT2haNU51U28xZWd3SWhBTDFhKy9ocDg4REtKMHN2M2VUM0Z4V2NzNzF4bWJMS0QvUUozbVdhZ3JKTk1JSUM3akNDQW5XZ0F3SUJBZ0lJU1cwdnZ6cVkycGN3Q2dZSUtvWkl6ajBFQXdJd1p6RWJNQmtHQTFVRUF3d1NRWEJ3YkdVZ1VtOXZkQ0JEUVNBdElFY3pNU1l3SkFZRFZRUUxEQjFCY0hCc1pTQkRaWEowYVdacFkyRjBhVzl1SUVGMWRHaHZjbWwwZVRFVE1CRUdBMVVFQ2d3S1FYQndiR1VnU1c1akxqRUxNQWtHQTFVRUJoTUNWVk13SGhjTk1UUXdOVEEyTWpNME5qTXdXaGNOTWprd05UQTJNak0wTmpNd1dqQjZNUzR3TEFZRFZRUUREQ1ZCY0hCc1pTQkJjSEJzYVdOaGRHbHZiaUJKYm5SbFozSmhkR2×2YmlCRFFTQXRJRWN6TVNZd0pBWURWUVFMREIxQmNIQnNaU0JEWlhKMGFXWnBZMkYwYVc5dUlFRjFkR2h2Y21sMGVURVRNQkVHQTFVRUNnd0tRWEJ3YkdVZ1NXNWpMakVMTUFrR0ExVUVCaE1DVlZNd1dUQVRCZ2NxaGtqT1BRSUJCZ2dxaGtqT1BRTUJCd05DQUFUd0Z4R0VHZGRraGRVYVhpV0JCM2JvZ0tMdjNudXVUZUNOL0V1VDRUTlcxV1piTmE0aTBKZDJEU0pPZTdvSS9YWVh6b2pMZHJ0bWNMN0k2Q21FLzFSRm80SDNNSUgwTUVZR0NDc0dBUVVGQndFQkJEb3dPREEyQmdnckJnRUZCUWN3QVlZcWFIUjBjRG92TDI5amMzQXVZWEJ3YkdVdVkyOXRMMjlqYzNBd05DMWhjSEJzWlhKdmIzUmpZV2N6TUIwR0ExVWREZ1FXQkJRajhrbkVUNVBrN3lmbXhQWW9iRCtpdS8wdVN6QVBCZ05WSFJNQkFmOEVCVEFEQVFIL01COEdBMVVkSXdRWU1CYUFGTHV3M3FGWU00aWFwSXFaM3I2OTY2L2F5eVNyTURjR0ExVWRId1F3TUM0d0xLQXFvQ2lHSm1oMGRIQTZMeTlqY213dVlYQndiR1V1WTI5dEwyRndjR3hsY205dmRHTmhaek11WTNKc01BNEdBMVVkRHdFQi93UUVBd0lCQmpBUUJnb3Foa2lHOTJOa0JnSU9CQUlGQURBS0JnZ3Foa2pPUFFRREFnTm5BREJrQWpBNnozS0RVUmFac1liN05jTld5bUsvOUJmdDJROTFUYUtPdnZHY2dWNUN0NG40bVBlYldaK1kxVUVOajUzcHd2NENNREl0MVVRaHNLTUZkMnhkOHpnN2tHZjlGM3dzSVcyV1Q4WnlhWUlTYjFUNGVuMGJtY3ViQ1lraFlRYVpEd21TSFFBQU1ZSUJYekNDQVZzQ0FRRXdnWVl3ZWpFdU1Dd0dBMVVFQXd3bFFYQndiR1VnUVhCd2JHbGpZWFJwYjI0Z1NXNTBaV2R5WVhScGIyNGdRMEVnTFNCSE16RW1NQ1FHQTFVRUN3d2RRWEJ3YkdVZ1EyVnlkR2xtYVdOaGRHbHZiaUJCZFhSb2IzSnBkSGt4RXpBUkJnTlZCQW9NQ2tGd2NHeGxJRWx1WXk0eEN6QUpCZ05WQkFZVEFsVlRBZ2hvWVBhWjJjeW5EekFOQmdsZ2hrZ0JaUU1FQWdFRkFLQnBNQmdHQ1NxR1NJYjNEUUVKQXpFTEJna3Foa2lHOXcwQkJ3RXdIQVlKS29aSWh2Y05BUWtGTVE4WERURTJNVEV3TVRBNU5UY3dObG93THdZSktvWklodmNOQVFrRU1TSUVJQWpSdk9nWkxDa0w5ZmNCZjdOSm5RY3hsd2ltL09ieHkrcEltZ1M0TGRUYU1Bb0dDQ3FHU000OUJBTUNCRWN3UlFJZ1BKaHlkTXE5UDdTaHJFT2RxVk5KUk84QnN1MC93SXNCS0Y1cnlFR0JPSDRDSVFEeWo4Wml3VVV5alRJUFRUZDBKTTlaMExIdGZTQVhOWVN2T0t4eGN3MTlod0FBQUFBQUFBPT0iLCJoZWFkZXIiOnsiZXBoZW1lcmFsUHVibGljS2V5IjoiTUZrd0V3WUhLb1pJemowQ0FRWUlLb1pJemowREFRY0RRZ0FFNUdmb2t2U2Z3WnV3aXYwSGxKVE1MS0dlMS96dWtjejczSFlvVjh5cjNGNWdmZmthVmNQTmptNjFhdFNOZm9UZUxiSnQ1aHBLWkJuSWlwZlVXSXZxMmc9PSIsInB1YmxpY0tleUhhc2giOiJLMG9KcmJiYURVUDh6YitSUEZhTmxVUTdTU2I3T1FEWERVeU9vM0JXdDJzPSIsInRyYW5zYWN0aW9uSWQiOiIyYTNkZjhjNDg0Y2JmMDg1OTgyN2Y0ZDBkZjhkYjY4YjYyNjBlNTIxYWUwZmI4YjI1NDRmNzNiM2RlMDVlYjE5In19»,"language»:"ru»,"additionalParameters»: {},"preAuth»:"true"}

Описание параметров запроса приведено в таблице ниже.

Пример получаемого продавцом от Apple PKPaymentToken Object выглядит следующим образом:

1{
2  «paymentData»: {
3    «data»: «vj5Uvux7Im8DD8YhSOsJvw5lWmfl2HMUnTNWJhVfTehvFffRhDo54mfpjxMt9vJdp6DwD7fgcNHDxBvnj56qYG4DpOxg1fTSdXgPFrezprZHCrRxPhN/aQQEThe2pQ0c7hgzzZlA6TpkIR/Xtk6CTcEbD1W6znFVdvMgX8G96Gg4OAGl8GaTXdSU3wlMQL5E63CLQzPi1xHVErWl1OOn6hYQuREUDGc7mAjmqMyLwXp6mOwJZ6ZFO/b9HkgFi428rqtOH08AfqkfaIWwIIAz2w3xEoZrDXbgFpNBnN7F2oretCU1/dFvQJjDYbMorKQ8GJbWtlsVbKsy0U91eoUetDcyMpB9zc139STYVoC8yp6Yk6Mn3icCLY0ZBujq7/404kMGpnHgkNVqFc/4SN0U2XQ5rrb14DM8M69w=»,
4    «signature»: «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»,
5    «header»: {
6      «publicKeyHash»: «fpvAnSDwQFX4NX4pghdjpNwUFhoTH/DDGhew94uJaRA=»,
7      «ephemeralPublicKey»: «MFkwEwYHKoZIzj0CAQYIKoZIzj0DAQcDQgAErKZUfqvhlieGAOaCKeTB/oDEo29fS1jWSKemNDh3fIqmbfs86nL4BGtRsWRxWcMnHN6GFOQm1MEj4m7ZHxe78g==»,
8      «transactionId»: «38e4c267ef1de62a343d0eccada3f7e19f6b22ffc7ede899c039865432ba6aa2»
9    },
10    «version»: «EC_v1»
11  },
12  «transactionIdentifier»: «38E4C267EF1DE62A343D0ECCADA3F7E19F6B22FFC7EDE899C039865432BA6AA2»,
13  «paymentMethod»: {
14    «network»: «Visa»,
15    «type»: «debit»,
16    «displayName»: «Visa5223»
17  }
18}

Значение свойства paymentData (из примера выше), которое нужно закодировать в Base64 и передать в запросе на оплату в платёжный шлюз, выглядит следующим образом:

{
    «data»: «vj5Uvux7Im8DD8YhSOsJvw5lWmfl2HMUnTNWJhVfTehvFffRhDo54mfpjxMt9vJdp6DwD7fgcNHDxBvnj56qYG4DpOxg1fTSdXgPFrezprZHCrRxPhN\/aQQEThe2pQ0c7hgzzZlA6TpkIR\/Xtk6CTcEbD1W6znFVdvMgX8G96Gg4OAGl8GaTXdSU3wlMQL5E63CLQzPi1xHVErWl1OOn6hYQuREUDGc7mAjmqMyLwX+p6mOwJZ6ZFO\/b9HkgFi428rqtOH08AfqkfaIWwIIAz2w3xEoZrDXbgFpNBnN7F2oretCU1\/dFvQJjDYbMorKQ8+GJbWtlsVb+Ksy0U91eoUetDcyMpB9zc139STYVoC8yp6Yk6Mn3icCLY0ZBujq7\/404kMGpnHgkNVqFc\/4SN0U2XQ5rrb14DM8M69w=»,"signature»:"MIAGCSqGSIb3DQEHAqCAMIACAQExDzANBglghkgBZQMEAgEFADCABgkqhkiG9w0BBwEAAKCAMIID4jCCA4igAwIBAgIIJEPyqAad9XcwCgYIKoZIzj0EAwIwejEuMCwGA1UEAwwlQXBwbGUgQXBwbGljYXRpb24gSW50ZWdyYXRpb24gQ0EgLSBHMzEmMCQGA1UECwwdQXBwbGUgQ2VydGlmaWNhdGlvbiBBdXRob3JpdHkxEzARBgNVBAoMCkFwcGxlIEluYy4xCzAJBgNVBAYTAlVTMB4XDTE0MDkyNTIyMDYxMVoXDTE5MDkyNDIyMDYxMVowXzElMCMGA1UEAwwcZWNjLXNtcC1icm9rZXItc2lnbl9VQzQtUFJPRDEUMBIGA1UECwwLaU9TIFN5c3RlbXMxEzARBgNVBAoMCkFwcGxlIEluYy4xCzAJBgNVBAYTAlVTMFkwEwYHKoZIzj0CAQYIKoZIzj0DAQcDQgAEwhV37evWx7Ihj2jdcJChIY3HsL1vLCg9hGCV2Ur0pUEbg0IO2BHzQH6DMx8cVMP36zIg1rrV1O\/0komJPnwPE6OCAhEwggINMEUGCCsGAQUFBwEBBDkwNzA1BggrBgEFBQcwAYYpaHR0cDovL29jc3AuYXBwbGUuY29tL29jc3AwNC1hcHBsZWFpY2EzMDEwHQYDVR0OBBYEFJRX22\/VdIGGiYl2L35XhQfnm1gkMAwGA1UdEwEB\/wQCMAAwHwYDVR0jBBgwFoAUI\/JJxE+T5O8n5sT2KGw\/orv9LkswggEdBgNVHSAEggEUMIIBEDCCAQwGCSqGSIb3Y2QFATCB\/jCBwwYIKwYBBQUHAgIwgbYMgbNSZWxpYW5jZSBvbiB0aGlzIGNlcnRpZmljYXRlIGJ5IGFueSBwYXJ0eSBhc3N1bWVzIGFjY2VwdGFuY2Ugb2YgdGhlIHRoZW4gYXBwbGljYWJsZSBzdGFuZGFyZCB0ZXJtcyBhbmQgY29uZGl0aW9ucyBvZiB1c2UsIGNlcnRpZmljYXRlIHBvbGljeSBhbmQgY2VydGlmaWNhdGlvbiBwcmFjdGljZSBzdGF0ZW1lbnRzLjA2BggrBgEFBQcCARYqaHR0cDovL3d3dy5hcHBsZS5jb20vY2VydGlmaWNhdGVhdXRob3JpdHkvMDQGA1UdHwQtMCswKaAnoCWGI2h0dHA6Ly9jcmwuYXBwbGUuY29tL2FwcGxlYWljYTMuY3JsMA4GA1UdDwEB\/wQEAwIHgDAPBgkqhkiG92NkBh0EAgUAMAoGCCqGSM49BAMCA0gAMEUCIHKKnw+Soyq5mXQr1V62c0BXKpaHodYu9TWXEPUWPpbpAiEAkTecfW6+W5l0r0ADfzTCPq2YtbS39w01XIayqBNy8bEwggLuMIICdaADAgECAghJbS+\/OpjalzAKBggqhkjOPQQDAjBnMRswGQYDVQQDDBJBcHBsZSBSb290IENBIC0gRzMxJjAkBgNVBAsMHUFwcGxlIENlcnRpZmljYXRpb24gQXV0aG9yaXR5MRMwEQYDVQQKDApBcHBsZSBJbmMuMQswCQYDVQQGEwJVUzAeFw0xNDA1MDYyMzQ2MzBaFw0yOTA1MDYyMzQ2MzBaMHoxLjAsBgNVBAMMJUFwcGxlIEFwcGxpY2F0aW9uIEludGVncmF0aW9uIENBIC0gRzMxJjAkBgNVBAsMHUFwcGxlIENlcnRpZmljYXRpb24gQXV0aG9yaXR5MRMwEQYDVQQKDApBcHBsZSBJbmMuMQswCQYDVQQGEwJVUzBZMBMGByqGSM49AgEGCCqGSM49AwEHA0IABPAXEYQZ12SF1RpeJYEHduiAou\/ee65N4I38S5PhM1bVZls1riLQl3YNIk57ugj9dhfOiMt2u2ZwvsjoKYT\/VEWjgfcwgfQwRgYIKwYBBQUHAQEEOjA4MDYGCCsGAQUFBzABhipodHRwOi8vb2NzcC5hcHBsZS5jb20vb2NzcDA0LWFwcGxlcm9vdGNhZzMwHQYDVR0OBBYEFCPyScRPk+TvJ+bE9ihsP6K7\/S5LMA8GA1UdEwEB\/wQFMAMBAf8wHwYDVR0jBBgwFoAUu7DeoVgziJqkipnevr3rr9rLJKswNwYDVR0fBDAwLjAsoCqgKIYmaHR0cDovL2NybC5hcHBsZS5jb20vYXBwbGVyb290Y2FnMy5jcmwwDgYDVR0PAQH\/BAQDAgEGMBAGCiqGSIb3Y2QGAg4EAgUAMAoGCCqGSM49BAMCA2cAMGQCMDrPcoNRFpmxhvs1w1bKYr\/0F+3ZD3VNoo6+8ZyBXkK3ifiY95tZn5jVQQ2PnenC\/gIwMi3VRCGwowV3bF3zODuQZ\/0XfCwhbZZPxnJpghJvVPh6fRuZy5sJiSFhBpkPCZIdAAAxggGMMIIBiAIBATCBhjB6MS4wLAYDVQQDDCVBcHBsZSBBcHBsaWNhdGlvbiBJbnRlZ3JhdGlvbiBDQSAtIEczMSYwJAYDVQQLDB1BcHBsZSBDZXJ0aWZpY2F0aW9uIEF1dGhvcml0eTETMBEGA1UECgwKQXBwbGUgSW5jLjELMAkGA1UEBhMCVVMCCCRD8qgGnfV3MA0GCWCGSAFlAwQCAQUAoIGVMBgGCSqGSIb3DQEJAzELBgkqhkiG9w0BBwEwHAYJKoZIhvcNAQkFMQ8XDTE3MDMxNzEwMzgzOVowKgYJKoZIhvcNAQk0MR0wGzANBglghkgBZQMEAgEFAKEKBggqhkjOPQQDAjAvBgkqhkiG9w0BCQQxIgQgvL+q07\/reM0N\/5b0hwWT7TJReVTdS9QX5SPhiqeie+cwCgYIKoZIzj0EAwIERzBFAiEAttC68Xyzs6I0+tAKmg6x+0UrqmkQN\/V5c8RMMIEJHooCIHIgUHbAt2p5WrFHQKrAVL4c7nohRplZWVbVu6wbBeCgAAAAAAAA»,
    «header»: {
        «publicKeyHash»:"fpvAnSDwQFX4NX4pghdjpNwUFhoTH\/DDGhew94uJaRA=»,
        «ephemeralPublicKey»:"MFkwEwYHKoZIzj0CAQYIKoZIzj0DAQcDQgAErKZUfqvhlieGAOaCKeTB\/oDEo29fS1jWSKemNDh3fIqmbfs86nL4BGtRsWRxWcMnHN6GFOQm1MEj4m7ZHxe78g==»,
        «transactionId»:"38e4c267ef1de62a343d0eccada3f7e19f6b22ffc7ede899c039865432ba6aa2»
    },
    «version»:"EC_v1»
}

Примеры и описание ответа

Успешная оплата

{
«success»: true,
«data»: {
    «orderId»: «12312312123»
  }
}

Неуспешная оплата

{
  «error»: {
    «code»: 1,
    «description»: «Processing Error»,
    «message»: «Недостаточно средств на карте»
  },
  «success»: false
}

Описание параметров ответа приведено в таблице ниже.

Запрос на проведение рекуррентных платежей через Apple Pay (REST)

Для регистрации заказа используется запрос recurrentPayment.do (см. раздел Координаты подключения).

Пример запроса POST

1{
2  «userName»: «userName»,
3  «password»: «password»,
4  «orderNumber»: «UAF-203974-DE-12»,
5  «language»: «RU»,
6  «bindingId»: «binding_id»,
7  «amount»: 12 300,
8  «currency»: «810»,
9  «description»: «Test description»,
10  «additionalParameters»: {
11    «firstParamName»: «firstParamValue»,
12    «secondParamName»: «secondParamValue»
13  }
14 }

Описание параметров представлено в таблице ниже.

Примеры и описания ответа

Ниже представлен пример успешной оплаты.

{"success»: true,"data»: {"orderId»:"f7beebe4-7c9a-43cf-8e26-67ab741f9b9e"},"orderStatus»: {"errorCode»:"0»,"orderNumber»:"UAF-203974-DE-12»,"orderStatus»: 2,"actionCode»: 0,"actionCodeDescription»:»»,"amount»: 12300,"currency»:"810»,"date»: 1491333938243,"orderDescription»:"Test description»,"merchantOrderParams»: [{"name»:"firstParamName»,"value»:"firstParamValue"}, {"name»:"secondParamName»,"value»:"secondParamValue"}],"attributes»: [],"cardAuthInfo»: {"expiration»:"201912»,"cardholderName»:"sdf sdf»,"approvalCode»:"123456»,"paymentSystem»:"VISA»,"pan»:"411111**1111"},"authDateTime»: 1491333939454,"terminalId»:"11111»,"authRefNum»:"111111111111»,"paymentAmountInfo»: {"paymentState»:"DEPOSITED»,"approvedAmount»: 12300,"depositedAmount»: 12300,"refundedAmount»: 0},"bankInfo»: {"bankCountryName»:"<Неизвестно>"},"chargeback»: false,"operations»: [{"amount»: 12300,"cardHolder»:"sdf sdf»,"authCode»:"123456"}]}}

Ниже представлен пример неуспешной оплаты.

{
  «error»: {
    «code»: «10»,
    «description»: «Заказ с таким номером уже зарегистрирован.»,
    «message»: «Заказ с таким номером уже зарегистрирован.»
  },
  «success»: false
}

Описание параметров ответа приведено в таблице ниже.

Коды ошибок

Запрос на оплату через Google Pay (REST)

Для регистрации заказа используется запрос payment.do (см. раздел Координаты подключения).

Описание параметров представлено в таблице ниже.

"имя_параметра": "значение_параметра"

Ниже представлен пример запроса на оплату.

1{
2    «merchant»: «OurBestMerchantLogin»,
3    «orderNumber»: «UAF-203974-DE»,
4    «language»: «RU»,
5    «preAuth»: true,
6    «description»: «Test description»,
7    «additionalParameters»:
8    {
9        «firstParamName»: «firstParamValue»,
10        «secondParamName»: «secondParamValue»
11    },
12    «paymentToken»: «eyJtZXJjaGFudCI6ICJrdXBpdmlwIiwib3JkZXJOdW1iZXIiOiAyMDUxOTIzMzkxLCJwYXltZW50VG9rZW4iOiAie1wiZXBoZW1lcmFsUHVibGljS2V5XCI6XCJrZXlcIixcImVuY3J5cHRlZE1lc3NhZ2VcIjpcIm1lc3NhZ2VcIixcInRhZ1wiOlwidGFnXCJ9In0=»,
13    «ip»: «127.0.0.1»,
14    «amount»: «230000»,
15    «currencyCode»: 643
16}

Описание параметров ответа приведены в таблице ниже.

Примеры и описание ответа

Успешная оплата

{
«success»: true,
«data»: {
 «orderId»: «12312312123»
 }

Не успешная оплата

{
  «error»: {
    «code»: 1,
    «description»:
«Processing Error»,
    «message»:
«Недостаточно средств на карте»
  },
  «success»: false
}

Описание возможных кодов ошибок представлено в таблице ниже.

Запрос на оплату чере AlfaPay (/alfapay/payment.do)

Для регистрации и инициации оплаты c помощью AlfaPay используется метод /alfapay/payment.do. (см. раздел Координаты подключения).
Метод: HTTP POST.
Параметры запроса:

Ниже представлены параметры блока billingPayerData (данные об адресе регистрации клиента).

Пример запроса:

1{
2    "username":"test",
3    "password":"testPass",
4    "orderNumber": "UAF-203974-DE",
5    "language": "RU",
6    "preAuth": false,
7    "description" : "Test description",
8    "additionalParameters":
9    {
10        "firstParamName": "firstParamValue",
11        "secondParamName": "secondParamValue"
12    },
13    "ip" : "127.0.0.1",
14    "amount" : "230000",
15    "currencyCode" : 643,
16    "failUrl" : "https://test.ru"
17    "returnUrl" : "https://test_return.ru"
18  }
19}

Параметры ответа:

Пример успешного ответа:

{
"success":true,
"data": {
    "orderId": "e757d0cf-a028-7bdc-acb9-44480008afa2"
    "redirect": "https://alfapay.com"
 }
}

Пример неуспешного ответа:

{
"success": false,
"error": {
    "code": 7,
    "message": "Системная ошибка"
  }
}