Справочник
Справочник. Статусы платежа
| Значение | Статус |
|---|---|
| ON-PAYMENT | Платеж исполняется |
| NEW | Платеж создан, ожидается ввод реквизитов |
| APPROVED | Платеж успешен |
| DECLINED | Платеж отклонен |
| REFUNDINPROC | В процессе возврата |
| REFUNDED | Возвращен |
| EXPIRED | Платеж просрочен |
| WAITING-AUTH | Ожидает подтверждение авторизации |
| 3ds | Требует проверки 3D-Secure |
| NEEDS-CLARIFICATION | Требует уточнения статуса платежа |
Справочник. Коды ответов
| Код | Расшифровка | Расшифровка (ENG) |
|---|---|---|
| 1 | ОПЕРАЦИЯ РАЗРЕШЕНА | |
| 50 | Финансовая транзакция не выполнена | General |
| 51 | Карта клиента просрочена | Expired card |
| 52 | Превышено число попыток ввода PIN | Number of PIN tries exceeded |
| 53 | Не удалось маршрутизировать транзакцию | No sharing allowed |
| 55 | Транзакция имеет некорректные атрибуты или данная операция не разрешена | Invalid transaction |
| 56 | Запрашиваемая операция не поддерживается хостом | Transaction not supported by institution |
| 57 | Карта клиента имеет статус 'потеряна' или 'украдена' | Lost or stolen card |
| 58 | Карта клиента имеет неправильный статус | Invalid card status |
| 59 | Карта клиента имеет ограниченные возможности | Restricted status |
| 60 | Не найден вендор с указанным номером счета | Account not found |
| 61 | Неверное количество информационных полей для заданного вендора | Wrong customer information for payment |
| 62 | Неверный формат информационного поля платежа | Customer information format error |
| 63 | Не найден prepaid-код | Prepaid Code not found |
| 64 | Track2 карты клиента содержит неверную информацию | Bad track information Track2 |
| 69 | Неверный формат сообщения | Bad message edit |
| 74 | Невозможно авторизовать | Unable to authorize |
| 75 | Неверный PAN карты | Invalid credit PAN |
| 76 | На счете не хватает средств | Insufficient funds |
| 78 | Произошло дублирование транзакции | Duplicate transaction received |
| 82 | Превышение количества использований карты клиента | Maximum number of times used |
| 85 | Невозможно выдать баланс | Balance not allowed |
| 95 | Превышение лимита по сумме | Amount over maximum |
| 100 | Невозможно провести транзакцию | Unable to process |
| 101 | Невозможно авторизовать – необходимо позвонить издателю карты | Unable to authorize – call issuer |
| 105 | Данный тип карт не поддерживается | Card not supported |
| 200 | Неправильный счет клиента | Invalid account |
| 201 | Неправильный PIN | Incorrect PIN |
| 205 | Некорректная сумма | Invalid advance amount |
| 209 | Неверный код транзакции | Invalid transaction code |
| 210 | Ошибка проведения 3DS авторизации | 3DS Authorization Failed |
| 211 | Неверное значение CVV2 | Bad Cvv2 |
| 212 | Не найдена оригинальная транзакция для слипа | Original transaction not found for slip |
| 213 | Слип принимается повторно | Slip already received |
| 501 | Транзакция выполнена успешно | Approved |
| 502 | Транзакция выполнена успешно на частичную сумму | Partially approved |
| 503 | Транзакция выполнена успешно только на сумму покупки (для транзакции 118 – Purchase with Cashback) | Purchase only approved |
| 510 | Нет номера счета в запросе транзакции, есть несколько счетов указанного типа, и терминал поддерживает выбор счета | Should select account number |
| 511 | Необходимо сменить PVV (разрешена только транзакция PIN Change) | Should change PVV |
| 512 | Необходимо подтвердить результаты проверки платежа в системе online-приема платежей | Confirm Payment Precheck |
| 513 | Транзакция запроса списка уведомлений выполнена успешно | Select Bill |
| 514 | Необходимо подтвердить результаты предпроверки операции | Customer confirmation requested |
| 515 | Не найдена оригинальная транзакция | Original transaction not found |
| 516 | Слип уже принят | Slip already received |
| 517 | Ошибка в реквизитах платежа | Personal information input error |
| 520 | Невозможно захватить Prepaid-код | Prepaid code not found |
| 521 | Баланс корр. счета исчерпан | Corresponding account exhausted |
| 522 | Превышен эквайринговый лимит | Acquirer limit exceeded |
| 524 | Истек срок действия динамического PVV | Dynamic PVV Expired |
| 525 | Слабый PIN | Weak PIN |
| 540 | Карта потеряна | Lost card |
| 541 | Карта украдена | Stolen card |
| 549 | Недопустимый тип платежа для данного вендора | Ineligible vendor account |
| 550 | Несанкционированное использование | Unauthorized usage |
| 551 | Истек срок действия карты | Expired card |
| 552 | Неверная карта | Invalid card |
| 553 | Неверный PIN-код | Invalid PIN |
| 554 | Системная ошибка | System error |
| 555 | Неподходящая транзакция | Ineligible transaction |
| 556 | Неподходящий счет | Ineligible account |
| 557 | Транзакция не поддерживается | Transaction not supported |
| 558 | Карта ограничена (данная операция по карте не разрешена) | Restricted Card |
| 559 | Недостаточно средств на счете | Insufficient funds |
| 560 | Превышен лимит на число использований карты | Uses limit exceeded |
| 561 | Лимит на снятие наличных будет превышен | Withdrawal limit would be exceeded |
| 562 | Достигнут или превышен лимит на число неверных вводов PIN-кода | PIN tries limit was reached |
| 563 | Достигнут лимит на снятие наличных | Withdrawal limit already reached |
| 564 | Достигнут лимит на депозит | Credit amount limit |
| 565 | Нет информации для предоставления отчета по счету | No statement information |
| 566 | Предоставление отчета по счету невозможно (запрещено) | Statement not available |
| 567 | Недопустимая сумма | Invalid amount |
| 568 | Транзакция отвергнута внешним хостом | External decline |
| 569 | Несогласованный запрос (данная карта не обслуживается в данном терминале) | No sharing |
| 571 | Необходимо обратиться к издателю | Contact card issuer |
| 572 | Авторизатор недоступен | Destination not available |
| 573 | Ошибка маршрутизации | Routing error |
| 574 | Ошибка формата | Format error |
| 575 | Транзакция отвергнута внешним хостом по специальному условию (владелец карты подозревается в мошенничестве) | External decline special condition |
| 580 | Неверный CVV | Bad CVV |
| 581 | Неверный CVV2 | Bad CVV2 |
| 582 | Неверная транзакция (транзакция не разрешена с такими условиями проведения) | Invalid transaction |
| 583 | Лимит на число неверных вводов PIN-кода УЖЕ достигнут (т.е. ранее был достигнут лимит на число неверных вводов PIN-кода, после чего был введен верный PIN) | PIN tries limit was exceeded |
| 584 | Неверное значение проверочного числа 3D Secure Cardholder Authentication Verification Value | Bad CAVV |
| 585 | Неверное значение криптограммы ARQC | Bad ARQC |
| 800 | Ошибка формата | Format error |
| 801 | Не найдена оригинальная транзакция для реверса | Original transaction not found |
| 809 | Неверная операция закрытия периода | Invalid close transaction |
| 810 | Произошел тайм-аут | Transaction timeout |
| 811 | Системная ошибка | System error |
| 820 | Неправильный идентификатор терминала | Invalid terminal identifier |
| 880 | Был послан последний пакет - прогрузка успешно завершена | Download has been received in its entirety |
| 881 | Предыдущий этап прогрузки был успешно выполнен – имеются еще данные | Download received successfully and there is more data for this download |
| 882 | Прогрузка терминала остановлена. Необходимо позвонить в процессинговый центр | Download aborted (call for service) |
| 897 | Получена неверная криптограмма в транзакции | Invalid cryptogram |
| 898 | Получен неверный MAC | Invalid MAC |
| 899 | Ошибка синхронизации | Sequence error—resync |
| 900 | Превышено число попыток ввода PIN. Требуется захват карты | Pin Tries Limit Exceeded |
| 901 | Карта просрочена, требуется захват карты | Expired Card |
| 909 | Требуется захват карты | External Decline Special Condition |
| 959 | Административная транзакция не поддерживается | Administrative transaction not supported |
| 2001 | Необходима верификация 3DS | Need 3ds verify |
| 2002 | Необходима верификация 3DS | Need 3ds verify |
Справочник. Дополнительная информация о причине отклонения платежа
| declineCategory | Расшифровка |
|---|---|
| ReattemptNotAllowed | Запрещено повторять транзакцию |
| ReattemptAllowedLater | Транзакцию невозможно одобрить сейчас, ее можно выполнить позже |
| ReattemptAfterCorrection | Если доступна новая информация о карте, инициатор может попытаться обновить данные карты и повторить операцию |
| ReattemptAfterCorrectionDCardData | Требования к токенам этого типа не выполнены |
| PaymentCancellation | Отмена платежа |
| MerchantDNQForProductCode | Продавец не имеет права обрабатывать транзакции по карточкам этого кода продукта |
| RetryAfter1Hour | Повторить через час |
| RetryAfter24Hours | Повторить через 24 часа |
| RetryAfter2Days | Повторить через 2 дня |
| RetryAfter4Days | Повторить через 4 дня |
| RetryAfter6Days | Повторить через 6 дней |
| RetryAfter8Days | Повторить через 8 дней |
| RetryAfter10Days | Повторить через 10 дней |
| IssuerRecognizesProdNonReloadable | Транзакция с предоплаченной картой, которую нельзя пополнять |
| IssuerRecognizesProdSingleVirtualCardNum | Транзакция с одноразовой виртуальной картой |
| ApplicableValueExceeded | Услуга подсчета баллов санкций: балл превышает доступное пороговое значение |
| TranWithMultitimeVirtualCard | Транзакция, выполненная с помощью многократной виртуальной карты |
Справочник. Коды системных ошибок
| Код | Расшифровка |
|---|---|
| -1 | Системная ошибка |
| -2 | Не передан параметр merchant_id |
| -3 | Мерчант не найден |
| -4 | Неправильная подпись |
| -5 | Лимит на выполнение операций |
| -6 | Неверный номер карты |
| -7 | Неверная валюта |
| -8 | Неверный order_id |
| -9 | Операция с таким order_id уже существует |
| -10 | Платеж не найден |
| -11 | Неверный тип операции |
| -12 | Ошибка операции |
| -13 | Ошибка валидации |
| -14 | Платежный провайдер не найден |
| -15 | Статус платежа требует уточнения |
| -16 | Неправильная ссылка |
| -17 | Ссылка не найдена |
| -18 | Платеж отклонен из-за выявленных проблем с безопасностью. Пожалуйста, попробуйте позже или обратитесь в службу поддержки |
| -19 | Запрос запрещен с данного IP-адреса |
| -20 | Для выполнения операции необходимо заполнить обязательный параметр ФИО |
| -998 | Произошла системная ошибка |
| -999 | Системная ошибка |
Справочник. Список дополнительных полей для идентификации отправителя и получателя переводов
⚠️ У каждой страны по требованиям национального банка обязательные поля могут отличаться, в документации обозначены поля которые обязательны для всех, независимо от требований национального регулятора!
Дополнительные поля передаются в запросе в параметре add_params
| Параметр | Тип | Обязательный | Описание |
|---|---|---|---|
| add_params[PurposeOfPayment] | string | Код назначения перевода (см. Справочник. VISA - Список стандартизованных кодов назначения платежа) | |
| Данные отправителя | |||
| add_params[SenderName] | string | Для P2PCredit, P2PDebit | ФИО отправителя |
| add_params[IdentityNumber] | string | Номер идентификационного документа отправителя (ИНН). Не обязателен для P2PCredit | |
| add_params[SenderAccount] | string | Номер карты или IBAN отправителя | |
| add_params[ResidentCountry] | string | Для P2PCredit, P2PDebit | Страна проживания отправителя |
| add_params[SenderState] | string | Для P2PCredit и P2PDebit для Канады и США | Штат/область отправителя |
| add_params[ResidentCity] | string | Для P2PCredit, P2PDebit | Город отправителя |
| add_params[Address] | string | Для P2PCredit, P2PDebit | Адрес отправителя |
| add_params[SenderDateOfBirth] | string | Дата рождения отправителя | |
| add_params[SenderPostalCode] | string | Для P2PDebit | Почтовый код отправителя |
| add_params[MobilePhone] | string | Мобильный телефон отправителя | |
| add_params[Phone] | string | Домашний телефон отправителя | |
| add_params[SenderBillAddrLine1] | string | Номер дома отправителя | |
| add_params[SenderBillAddrLine2] | string | Номер корпуса отправителя | |
| add_params[SenderBillAddrLine3] | string | Номер квартиры отправителя | |
| add_params[SenderCountryOfBirth] | string | Страна рождения отправителя | |
| add_params[SenderNationality] | string | Гражданство отправителя | |
| add_params[SenderIdentificationType] | string | Тип документа отправителя | |
| add_params[SenderIdentificationCountryCode] | string | Для P2PDebit | Код страны документа отправителя |
| add_params[SenderIDCode] | string | Код документа отправителя | |
| add_params[SenderIDExp] | string | Дата истечения срока действия документа отправителя | |
| Данные получателя | |||
| add_params[RecipientName] | string | Для P2PCredit, P2PDebit | ФИО получателя |
| add_params[RecipientOrganizationName] | string | Название юридического лица получателя | |
| add_params[RecipientAccount] | string | Номер карты или IBAN получателя | |
| add_params[RecipientIdentityNumber] | string | Номер идентификационного документа отправителя (ИНН) | |
| add_params[ContractNumber] | string | Номер договора | |
| add_params[RecipientDateOfBirth] | string | Дата рождения получателя | |
| add_params[RecipientCountry] | string | Страна проживания получателя | |
| add_params[RecipientPostalCode] | string | Почтовый код получателя | |
| add_params[RecipientCity] | string | Город получателя | |
| add_params[RecipientAddress] | string | Адрес получателя | |
| add_params[RecipientMobilePhone] | string | Мобильный телефон получателя | |
| add_params[RecipientPhone] | string | Домашний телефон получателя | |
| add_params[RecipientState] | string | Штат/область получателя | |
| add_params[RecipientBillAddrLine1] | string | Номер дома получателя | |
| add_params[RecipientBillAddrLine2] | string | Номер корпуса получателя | |
| add_params[RecipientBillAddrLine3] | string | Номер квартиры получателя | |
| add_params[RecipientCountryOfBirth] | string | Страна рождения получателя | |
| add_params[RecipientNationality] | string | Гражданство получателя | |
| add_params[RecipientIdentificationType] | string | Тип документа получателя | |
| add_params[RecipientIdentificationCountryCode] | string | Код страны документа получателя | |
| add_params[RecipientIDCode] | string | Код документа получателя | |
| add_params[RecipientIDExp] | string | Дата истечения срока действия документа получателя |
Справочник. VISA - Список стандартизованных кодов назначения платежа
| Значение | Описание |
|---|---|
| ISACCT | Управление учетными записями |
| ISALLW | Операция представляет собой выплату пособия |
| ISANNI | Урегулирование аннуитета |
| ISBENE | Пособие по безработице |
| ISBEXP | Деловые расходы |
| ISBONU | Бонусная выплата |
| ISBUSB | Бизнес, связанный с автобусными перевозками |
| ISCASH | Перевод денежных средств в рамках управления денежными средствами |
| ISCBTV | Оплата счета за кабельное телевидение |
| ISCCHD | Правительственный институт издал документы, касающиеся денежных компенсаций, беспомощности и инвалидности |
| ISCCRD | Оплата кредитной картой |
| ISCDBL | Оплата счета по кредитной карте |
| ISCHAR | Оплата в благотворительных целях |
| ISCOLL | Сбор платежей |
| ISCOMC | Коммерческий платеж |
| ISCOMM | Комиссия |
| ISCOMP | Компенсация, связанная с убытками от процентов/корректировкой даты начисления процентов, может включать в себя сборы |
| ISCPYR | Оплата авторских прав |
| ISDCRD | Связано с оплатой дебетовой картой |
| ISDEPT | Внесение залога |
| ISDIVD | Выплата дивидендов |
| ISEDUC | Оплата обучения/платы за обучение |
| ISELEC | Оплата счета за электроэнергию |
| ISENRG | Энергии |
| ISFEES | Общие сборы |
| ISFERB | Оплата услуг, связанных с паромами |
| ISFREX | Валютный обмен |
| ISGASB | Оплата счета за газ |
| ISGFRP | Выплата компенсаций безработным в ходе процедур банкротства |
| ISGOVT | Государственный платеж |
| ISHLTI | Медицинское страхование |
| ISICCP | Возмещение платежа по кредитной карте |
| ISIDCP | Возмещение платежа с дебетовой карты |
| ISINPC | Оплата страхового взноса за автомобиль |
| ISINSC | Данная операция связана с выплатой страхового возмещения |
| ISINSM | Рассрочка |
| ISINSU | Страховая премия |
| ISINVS | Оплата паевых инвестиционных фондов, инвестиционных продуктов и акций |
| ISINTC | Внутрикорпоративные платежи |
| ISINTE | Интерес |
| ISINTX | Подоходный налог |
| ISINVS | Инвестиции |
| ISLBRI | Страхование труда |
| ISLICF | Лицензионный сбор |
| ISLIFI | Страхование жизни |
| ISLOAN | Заем |
| ISMDCS | Медицинские услуги |
| ISMP2B | Мобильные платежи P2B |
| ISMP2P | Мобильные P2P-платежи |
| ISMTUP | Пополнение мобильного счета |
| ISNOWS | Если не указано иное |
| ISOTHR | Другой |
| ISOTLC | Данная транзакция связана с оплатой других счетов, связанных с телекоммуникациями |
| ISPAYR | Расчет заработной платы |
| ISPEFC | Взнос в пенсионный фонд |
| ISPENS | Выплата пенсии |
| ISPHON | Оплата телефонного счета |
| ISPPTI | Страхование имущества |
| ISRELG | Сделка касается обычной аренды/лизинга |
| ISRENT | Оплата арендной платы |
| ISRLWY | Оплата услуг, связанных с железнодорожным транспортом |
| ISROYA | Авторские отчисления |
| ISSALA | Выплата заработной платы |
| ISSAVG | Оплата на сберегательный/пенсионный счет |
| ISSECU | Ценные бумаги |
| ISSSBE | Пособие по социальному обеспечению |
| ISSTDY | Учеба |
| ISSUBS | Подписка |
| ISSUPP | Оплата поставщику |
| ISTAXR | Возврат налогового платежа или обязательства |
| ISTAXS | Уплата налога |
| ISTBIL | Данная транзакция связана с оплатой счета за телекоммуникационные услуги |
| ISTRAD | Операция торговых услуг |
| ISTREA | Платеж казначейства |
| ISTRPT | Оплата проезда |
| ISUBIL | Оплата коммунальных счетов |
| ISVATX | Уплата налога на добавленную стоимость |
| ISWHLD | Удержание |
| ISWTER | Оплата счета за воду |
Справочник. Значения параметра secure_type
Значение параметра secure_type будет применяться только, если для магазина есть соответствующее разрешение. Для получения такого разрешения свяжитесь с технической поддержкой.
| Значение | Описание |
|---|---|
| 1 | Платежи токенами (GooglePay/ApplePay) и картами с 3DS |
| 2 | Платежи токенами (GooglePay/ApplePay) и картами без 3DS |
| 3 | Платежи токенами (GooglePay/ApplePay) без 3DS, картами - с 3DS |