ANDROID
, IOS
.
{"errorCode": "INTERNAL_SERVICE_ERROR","descriptions": ["Описание ошибки 1","Описание ошибки 2"],"message": "Возникла непредвиденная ошибка"}
Запрос направляется от Cardsmobile к эмитенту.
{"productRequestId": "4ee64eb1-0012-4cd0-aefe-966d48ea7b71","productId": "AAA_1","platform": "ANDROID","form": {...}}
APPROVED
— заявка на выпуск одобрена эмитентом;
DECLINED
— заявка отклонена эмитентом;AUTHENTICATION_REQUIRED
— требуется дополнительная аутентификация клиента.
{"errorCode": "INTERNAL_SERVICE_ERROR","descriptions": ["Описание ошибки 1","Описание ошибки 2"],"message": "Возникла непредвиденная ошибка"}
Запрос направляется от эмитента к Cardsmobile.
{"productRequestId": "4ee64eb1-0012-4cd0-aefe-966d48ea7b71","issuerId": 5,"status": "AUTHENTICATION_REQUIRED","authenticationMethods": [{"methodId": 4,"type": "WEB_LINK","value": "https://my-bank/card"}]"userMessage": "Требуется дополнительная аутентификация пользователя"}
См. описание объекта AuthenticationMethod.
status
, установленным в значение AUTHENTICATION_REQUIRED и пользователь произвел выбор метода аутентификации из предложенных эмитентом.
{"errorCode": "INTERNAL_SERVICE_ERROR","descriptions": ["Описание ошибки 1","Описание ошибки 2"],"message": "Возникла непредвиденная ошибка"}
Запрос направляется от Cardsmobile к эмитенту. Перечень допустимых методов идентификации предварительно согласовывается эмитентом и Cardsmobile.
{"productRequestId": "4ee64eb1-0012-4cd0-aefe-966d48ea7b71","methodId": 2}
status
имеет значение AUTHENTICATION_REQUIRED, а поле authenticationMethod
— значение OTP_CODE.
{"errorCode": "INTERNAL_SERVICE_ERROR","descriptions": ["Описание ошибки 1","Описание ошибки 2"],"message": "Возникла непредвиденная ошибка"}
Запрос направляется от Cardsmobile к эмитенту.
{"productRequestId": "4ee64eb1-0012-4cd0-aefe-966d48ea7b71","value": "12345"}
EncryptedPayload
.
{"errorCode": "INTERNAL_SERVICE_ERROR","descriptions": ["Описание ошибки 1","Описание ошибки 2"],"message": "Возникла непредвиденная ошибка"}
Запрос направляется от Cardsmobile к эмитенту.
{"productRequestId": "4ee64eb1-0012-4cd0-aefe-966d48ea7b71","appleWalletProvisionRequest": {},"encryptedPayload": {}}
Поле encryptedPayload
заполняется только в случае, если ожидается, что эмитент будет передавать Cardsmobile в ответном запросе чувствительные данные карты, например — проверочный код CVC2/CVV2. Расшифрованное значение поля encryptedData
объекта EncryptedPayload имеет вид объекта JSON:
{"appOneTimePublicKey": "<значение ключа>"}
где appOneTimePublicKey
— одноразовый открытый ключ экземпляра мобильного приложения «Кошелёк».
Поле appleWalletProvisionRequest
заполняется только в случае, если выпущенный экземпляр продукта подлежит загрузке в Apple Wallet.
EncryptedPayload
.
{"errorCode": "INTERNAL_SERVICE_ERROR","descriptions": ["Описание ошибки 1","Описание ошибки 2"],"message": "Возникла непредвиденная ошибка"}
Запрос направляется от эмитента к Cardsmobile.
{"productRequestId": "4ee64eb1-0012-4cd0-aefe-966d48ea7b71","productInstanceId": "cf94bc49-333b-491a-ba8b-9329849ed7e5","issuerId": 5,"encryptedPayload1": {...},"encryptedPayload2": {...},"appleWalletProvisionResponse": ""}
В поле encryptedPayload1
передается объект EncryptedPayload, расшифрованное значение поля encryptedData
которого имеет вид объекта JSON:
Имя | Тип | Описание |
| String | Тип банковского продукта, например: BANK_CARD. |
| String | PAN (Номер банковской карты), если type=BANK_CARD. |
| String | Дата окончания действия карты, если type=BANK_CARD. |
| String | Идентификатор статуса карты, если type=BANK_CARD. |
| String | Имя владельца карты, если type=BANK_CARD. |
Пример расшифрованного значения encryptedPayload1.encryptedData
:
{"type": "BANK_CARD","pan": "1111 1111 1111 1111","expDate": "01/23","statusId": "2","cardHolderName": "IVAN IVANOV"}
По согласованию с эмитентом, набор передаваемых в запросе полей может быть дополнен. Например, это может быть использовано в следующих ситуациях:
Для передачи идентификатора клиента в системе лояльности ритейлера для обладателя выпускаемой банковской карты, если она — кобрендинговая, то есть совмещена с картой лояльности ритейлера,
Для передачи TAV (Tokenization Authentication Value) для последующей токенизации выпущенной виртуальной карты по «зеленому» пути.
Поле encryptedPayload2
передается только если эмитент сообщает Cardsmobile контрольный код CVN (CVC2/CVV2). В этом поле передается объект EncryptedPayload, расшифрованное значение поля encryptedData
которого имеет вид объекта JSON:
{"value": "<значение CVN>"}
Ключ RGK для объекта в поле encryptedPayload2
должен быть зашифрован одноразовым открытым ключом, отправленным эмитенту от Cardsmobile в поле appOneTimePublicKey
зашифрованного объекта, переданного в запросе provisionRequest. В этом случае поле encryptedPayload2.encryptedData
возможно расшифровать только на в экземпляре мобильного приложения «Кошелёк», работающем на устройстве пользователя-получателя сведений о карте.
Поле encryptedPayload1.encryptedData
возможно расшифровать только на узле Cardsmobile.
{"errorCode": "INTERNAL_SERVICE_ERROR","descriptions": ["Описание ошибки 1","Описание ошибки 2"],"message": "Возникла непредвиденная ошибка"}
Запрос направляется от Cardsmobile к эмитенту. Необязательный запрос.
{"productRequestId": "4ee64eb1-0012-4cd0-aefe-966d48ea7b71","productInstanceId": "cf94bc49-333b-491a-ba8b-9329849ed7e5","deliveryMethodId": 2,"requestedParamIds": [1, 3]}
В случае использование этого запроса при взаимодействии с Cardsmobile, эмитент должен определить варианты доставки пользователю информации по продукту. При необходимости перечень идентификаторов может быть дополнен.
{"errorCode": "INTERNAL_SERVICE_ERROR","descriptions": ["Описание ошибки 1","Описание ошибки 2"],"message": "Возникла непредвиденная ошибка"}
Запрос направляется от эмитента к Cardsmobile. Необязательный запрос.
{"requestId": "896a0038-e2d5-4248-964d-fe6caf9130d9","issuerId": 5,"productInstanceId": "cf94bc49-333b-491a-ba8b-9329849ed7e5","encryptedPayload": {...},}
В поле encryptedPayload
передается объект EncryptedPayload, расшифрованное значение поля encryptedData
которого имеет вид объекта JSON:
Имя | Тип | Описание |
| Integer | Идентификатор статуса экземпляра продукта, в который его перевел эмитент. |
| String | Сообщение пользователю от эмитента (не более 200 символов, кодировка UTF-8). |
Пример расшифрованного значения encryptedPayload.encryptedData
:
{"statusId": 3,"userMessage": "Карта заблокирована"}
{"errorCode": "INTERNAL_SERVICE_ERROR","descriptions": ["Описание ошибки 1","Описание ошибки 2"],"message": "Возникла непредвиденная ошибка"}
Запрос направляется от Cardsmobile к эмитенту. Необязательный запрос.
{"requestId": "896a0038-e2d5-4248-964d-fe6caf9130d9","productInstanceId": "cf94bc49-333b-491a-ba8b-9329849ed7e5","encryptedPayload": {...}}
В поле encryptedPayload
передается объект EncryptedPayload, расшифрованное значение поля encryptedData
которого имеет вид объекта JSON:
Имя | Тип | Описание |
| Integer | Идентификатор статуса экземпляра продукта, который к нему желает применить пользователь. |
Пример расшифрованного значения encryptedPayload.encryptedData
:
{"statusId": 3}
{"errorCode": "INTERNAL_SERVICE_ERROR","descriptions": ["Описание ошибки 1","Описание ошибки 2"],"message": "Возникла непредвиденная ошибка"}
Запрос направляется от Cardsmobile к эмитенту. Необязательный запрос.
{"requestId": "896a0038-e2d5-4248-964d-fe6caf9130d9","productInstanceId": "cf94bc49-333b-491a-ba8b-9329849ed7e5"}
{"errorCode": "INTERNAL_SERVICE_ERROR","descriptions": ["Описание ошибки 1","Описание ошибки 2"],"message": "Возникла непредвиденная ошибка"}
Запрос направляется от эмитента к Cardsmobile. Необязательный запрос.
{"requestId": "1e8650dd-b52e-4b6c-b526-75aa6b00cae2","issuerId": 5,"productInstanceId": "cf94bc49-333b-491a-ba8b-9329849ed7e5","amount": 631.15,"currencyCode": "RUB"}
{"errorCode": "INTERNAL_SERVICE_ERROR","descriptions": ["Описание ошибки 1","Описание ошибки 2"],"message": "Возникла непредвиденная ошибка"}
Запрос направляется от Cardsmobile к эмитенту. Необязательный запрос.
{"requestId": "295914cd-2ada-49cd-93ba-172e37e13af5","productInstanceId": "cf94bc49-333b-491a-ba8b-9329849ed7e5","fromTimestamp": "2019-06-05T18:23:05+03:00","limit": 10}
{"errorCode": "INTERNAL_SERVICE_ERROR","descriptions": ["Описание ошибки 1","Описание ошибки 2"],"message": "Возникла непредвиденная ошибка"}
Запрос направляется от эмитента к Cardsmobile. Необязательный запрос.
{"requestId": "d204cd1b-a78a-4ec3-a356-9231dbe57cac","issuerId": 2,"productInstanceId": "cf94bc49-333b-491a-ba8b-9329849ed7e5","productTransactions":[{"transactionId": "f477f5e3-5a06-4ea2-a0eb-b2ba12215674","transactionType": "PURCHASE","amount": 125.87,"currencyCode": "RUB","authorizationStatus": "AUTHORIZED","timestamp": "2019-06-05T18:23:05+03:00","merchantName": "...","merchantType": "5812"}]}
См. описание объекта ProductTransaction.
{"errorCode": "INTERNAL_SERVICE_ERROR","descriptions": ["Описание ошибки 1","Описание ошибки 2"],"message": "Возникла непредвиденная ошибка"}
Запрос направляется от эмитента к Cardsmobile. Необязательный запрос.
{"requestId": "d204cd1b-a78a-4ec3-a356-9231dbe57cac","issuerId": 2,"productInstanceId": "cf94bc49-333b-491a-ba8b-9329849ed7e5","productTransaction":{"transactionId": "f477f5e3-5a06-4ea2-a0eb-b2ba12215674","transactionType": "PURCHASE","amount": 125.87,"currencyCode": "RUB","authorizationStatus": "AUTHORIZED","timestamp": "2019-06-05T18:23:05+03:00","merchantName": "...","merchantType": "5812"}}
См. описание объекта ProductTransaction.