Page tree
Skip to end of metadata
Go to start of metadata

У цьому розділі представлені відомості про помилки, які можуть виникнути під час запуску ActiveServer.

Опис кодів помилок API аутентифікації

У ActiveServer існує 6 категорій кодів помилок:


1. Коди помилок 3DS

Коди помилок в цій категорії визначаються специфікаціями протоколу EMVCo Core. Коди помилок, визначені в цьому, можуть бути повернуті з сервера 3DS (ActiveServer), DS, ACS або 3DS SDK. Компонент, який ідентифікував помилку, поверне відповідь про помилку і встановить поле errorComponent як саме себе у відповіді JSON (наприклад, якщо помилка була ідентифікована DS, він встановить errorComponent в D). Якщо помилка була виявлена ​​в компоненті, що знаходиться за межами ActiveServer, він відправить ту ж помилку JSON в запитувач 3DS. Поля errorMessageType, errorDetail і errorDescription можуть використовуватися для інтерпретації повідомлення, яке було помилковим. Зверніться до моделі ApiErrorResponse для опису кожного поля.

2. Коди помилок транзакцій

Коди помилок транзакцій, певні ActiveServer. Поле errorComponent завжди буде S, тому що помилка була виявлена сервером 3DS.

3. Коды общих ошибок

Помилки, які не потрапляють ні в коди помилок 3DS, ні в коди помилок транзакцій, повертаються як загальний код. Ці коди помилок також можуть бути повернуті з Admin API. Ознайомтеся з описом API аутентифікації для отримання описів, пов'язаних з API аутентифікації.

4. Коди помилок безпеки

5. Коди помилок користувача

6. Код помилки установки


Додатково:

  • Тільки коди помилок в категоріях «Коди помилок 3DS», «Коди помилок транзакцій» і «Коди загальних помилок» можуть бути повернуті з API аутентифікації (/api/v2/auth/***).
  • Коди помилок безпеки, коди помилок користувача або код помилки установки не будуть повернені з API аутентифікації.
  • Для кожного коду помилки буде повернутий відповідний код стану HTTP з наведеної нижче таблиці.
  • Опис містить можливий сценарій, в якому може бути повернутий код помилки, і для деяких кодів помилок також виділені спільні рішення.

Коди помилок з тегом Not returned in Auth API v2 не будуть повернені в якості відповіді для /api/v2/auth/***.


1. Коди помилок 3DS (1101 ~ XXX)


Код

Назва

HTTP Status код

Опис

1101

MESSAGE_RECEIVED_INVALID

400

Отримане повідомлення недійсне. Повідомлення не є AReq, ARes, CReq, CRes, PReq, PRes, RReq або RRes. Наприклад, сервер 3DS отримує повідомлення від DS в якості відповіді на AReq, яке не є повідомленням ARes або Erro.

1102

MESSAGE_VERSION_NUMBER_

NOT_SUPPORTED

400

Непідтримуваний номер версії повідомлення. Отриманий номер версії повідомлення недійсний для приймаючого компонента. Наприклад, DS відправляє в поле messageVersion неприпустиме значення або значення, яке не підтримує ACS.

1103

SENT_MESSAGES_LIMIT_EXCEEDED

500

Відправлене повідомлення перевищує ліміт. Перевищено максимальну кількість повідомлень PReq, відправлених DS. Не повертається Auth API v2. (PReq знаходиться поза потоком аутентифікації і є внутрішнім процесом між ActiveServer і DS).

1201

REQUIRED_DATA_ELEMENT_MISSING

400

Відсутня елемент повідомлення, що вимагається згідно зі специфікацією. Цей код помилки буде повернений, якщо в запиті відсутнє будь-яке з полів, позначених обов'язкові. Наприклад, messageCategory відсутня у виклику / api / v2 / auth / brw. Якщо errorMessageType має значення AReq або відсутній, а errorComponent - S, то в запиті від запитуючої сторони 3DS відсутні обов'язкові поля, певні API аутентифікації. Будь ласка, двічі перевірте поля, які повертаються в errorDetail присутній в запиті.

1202

CRITICAL_MESSAGE_

EXTENSION_NOT_RECOGNISED

400

Відсутня критичне розширення повідомлення. Може бути повернуто з DS або ACS, якщо в поле messageExtension відсутня ідентифікатор.

1203

FORMAT_OF_ONE_OR_MORE

_DATA_ELEMENTS_IS_INVALID

_ACCORDING_TO_THE_SPECIFICATION

400

Елемент даних має неправильний формат або значення неприпустимо, як визначено в специфікації. Цей код помилки буде повернений, якщо будь-яка поле в запиті неправильно відформатовано. Наприклад, PurchaseAmount не є числовим при виклику / api / v2 / auth / brw. Якщо errorMessageType - AReq або порожньо, а errorComponent - S, то запит від запитуючої сторони 3DS не відповідає полях, певним API аутентифікації. Будь ласка, двічі перевірте форматування полів, що повертаються в errorDetail, присутній в запиті.

1204

DUPLICATE_DATA_ELEMENT

400

У запиті виявлені елементи, що повторюються даних.

1301

TRANSACTION_ID_NOT_RECOGNISED

400

Отриманий ідентифікатор транзакції недійсний для отримує компонента. Наприклад, 3DS Requestor встановлює threeDSSereverTransID в / api / v2 / auth / brw, який відрізняється від того, який повертається / api / v2 / auth / brw / init.

1302

DATA_DECRYPTION_FAILURE

500

Дані не можуть бути розшифровані приймаючої системою з технічних або інших причин. DS може повернути цей код помилки, якщо розшифровка зашифрованих даних SDK не вдалася.

1303

ACCESS_DENIED_INVALID_ENDPOINT

401

Кінцева точка для запиту API недійсна. Перевірте запитувач URL. Номер посилання не представляє бере участь компонент (наприклад, acsReferenceNumber, відправлений з ACS в DS, недійсний).

1304

ISO_CODE_INVALID

400

Код ISO недійсний відповідно до таблиць ISO (для країни або валюти).

1305

TRANSACTION_DATA_NOT_VALID

400

Дані транзакції недійсні. Будь ласка, зверніться до опису помилки, щоб дізнатися, чому дані транзакції були недійсними.

1306

MERCHANT_CATEGORY_CODE_MCC_

NOT_VALID_FOR_PAYMENT_SYSTEM

400

Код категорії продавця недійсний. У повідомленні AReq Отримано недійсну MCC, і DS може повернути цю помилку в ActiveServer.

1307

SERIAL_NUMBER_NOT_VALID

500

Серійний номер недійсний. Не повертається Auth API v2. (PReq знаходиться поза потоком аутентифікації і є внутрішнім процесом між ActiveServer і DS).

1402

TRANSACTION_TIMED_OUT

408

Час транзакції минув. У ActiveServer цей код помилки повертається, якщо час транзакції минув під час відправлення запиту в DS (наприклад, при відправці AReq в DS).

1403

TRANSIENT_SYSTEM_FAILURE

500

Система вийшла з ладу на короткий період. Наприклад, серверна система з повільною обробкою.

1404

PERMANENT_SYSTEM_FAILURE

500

Система вийшла з ладу назавжди. Наприклад, немає доступу до важливої ​​базі даних. Може бути повернуто, якщо параметри DS неправильно налаштовані в ActiveServer, наприклад, сертифікат клієнта для DS не встановлено в ActiveServer.

1405

SYSTEM_CONNECTION_FAILURE

500

Чи не вдалося підключитися до системи. Наприклад, передає компонент не може встановити з'єднання з приймаючим компонентом.


2. Коди помилок транзакцій (11001 ~ 11027)


Код

Назва

HTTP Status код

Опис

11001

DIRECTORY_SERVER_NOT_FOUND

500

Сервер каталогів не найден для схеми карти, пов'язаної з PAN. Може бути повернуто, якщо URL-адресу за замовчуванням порожній в інтерфейсі адміністрування для схеми карти. Переконайтеся, що URL-адресу за замовчуванням налаштований на панелі управління користувальницького інтерфейсу адміністратора ActiveServer.

11002

ERROR_SAVE_TRANSACTION

500

Помилка при збереженні транзакції. Може бути повернуто, якщо деталі транзакції не вдалося зберегти в базі даних під час аутентифікації.

11003

ERROR_SAVE_TRANSACTION_MESSAGE

500

Помилка при збереженні повідомлення про транзакції. Не повертається Auth API v2. Але якщо при збереженні необробленого повідомлення (наприклад, необробленого повідомлення AReq JSON) сталася помилка, транзакція не завершиться помилкою.

11004

UNHANDLED_EXCEPTION

500

Необроблене виняток сталося під час транзакції. Будь ласка, перевірте опис помилки або надішліть журнал помилок для подальшого дослідження.

11005

PAN_NOT_PARTICIPATING

400

Основний номер рахунку (PAN) не бере. Не повертається Auth API v2.

11009

MERCHANT_INTERFACE_DISABLED

400

Інтерфейс відключений для цього продавця. Не повертається Auth API v2. Замість цього буде повернутий MERCHANT_ID_THREEDS_REQUESTOR_ID_INVALID (1026).

11011

INVALID_LICENSE

403

Використовується недійсна ліцензія ActiveServer. Будь ласка, вирішіть цю проблему з ліцензуванням за допомогою GPayments якомога швидше.

11013

INVALID_TRANSACTION_ID

400

Ідентифікатор транзакції сервера 3DS не розпізнає. Цей код помилки може бути повернутий, якщо threeDSServerTransID недійсний в даному запиті.

11014

INVALID_REQUESTOR_TRANSACTION_ID

400

Ідентифікатор транзакції 3DS Requestor не розпізнає. Може бути повернуто, якщо threeDSRequestorTransID не в форматі UUID.

11015

THREEDS_REQUESTOR_NOT_FOUND

400

Недійсний ідентифікатор запитуючої сторони 3DS або ідентифікатор продавця. Не повертається Auth API v2. MERCHANT_ID_THREEDS_REQUESTOR_ID_INVALID (1026) буде повернуто, якщо сертифікат клієнта або merchantId недійсні.

11016

MISSING_REQUIRED_ELEMENT

400

Відсутня обов'язковий елемент. Може бути повернуто, якщо обов'язкові поля в API аутентифікації відсутні.

11018

ELEMENT_NOT_DEFINED

400

Елемент повідомлення не є певним сполученням. Не повертається Auth API v2.

11019

PROTOCOL_OLD

500

Версія протоколу занадто стара. Не повертається Auth API v2.

11020

ERROR_TRANSMISSION_DATA

500

Помилки при передачі даних. Він буде повернений в разі помилки при відправці запиту або отримання відповіді від DS. Якщо причиною помилки є тайм-аут запиту, замість цього буде повернуто код помилки TRANSACTION_TIMED_OUT (402). Якщо з'єднання не встановлено спочатку, воно поверне DIRECTORY_SERVER_NOT_AVAILABLE (+1001).

11021

PRIOR_TRANS_ID_NOT_FOUND

400

Ідентифікатор попередньої транзакції не може бути знайдений в базі даних або недійсний. Ця помилка може бути повернута, якщо PriorTransID, зазначений в запиті аутентифікації, не має допустимого формату UUID. PriorTransID повинен містити threeDSServerTransID, який використовувався в останній транзакції того ж власника карти.

11022

INVALID_FORMAT

400

Формат одного або декількох елементів неприпустимий відповідно до специфікації. Може бути повернуто, якщо поля в API аутентифікації мають неприпустимий формат. Наприклад, browserInfo, вказаний в / api / v2 / auth / brw, має інший формат, ніж той, який збирається ActiveServer.

11023

CARD_RANGE_IS_NOT_VALID

400

Зазначений діапазон карт недійсний. Не повертається Auth API v2.

11024

CACHE_UPDATE_IS_DISABLE

500

Оновлення кеша відключено. Не повертається Auth API v2.

11025

CACHE_REFRESH_INTERVAL_IS_NOT_SET

500

Частота оновлення кеша не встановлено. Не повертається Auth API v2.

11026

MERCHANT_ID_THREEDS_REQUESTOR_

ID_INVALID

400

Запитом аутентифікації переданий неприпустимий merchantId. Переконайтеся, що merchantId, зазначений в запиті, відповідає сертифікату клієнта для продавця або merchantToken, якщо використовується головний сертифікат клієнта. Якщо ви відкликали сертифікат клієнта, не забудьте оновити сертифікат клієнта або merchantToken в запиті API.

11027

UNSUPPORTED_API_VERSION

403

Ця помилка може виникнути, якщо версія API, до якої ви намагаєтеся відправити запит, не підтримується. Наприклад, API версії 1 цієї статті не підтримується для ActiveServer з AWS KMS.



3. Коди помилок загальні (12000 ~ 12009)


Код

Назва

HTTP Status код

Опис

API Auth Опис

12000

NOT_FOUND

404

Ресурс не знайдений.Чи не возвращается Auth API v2.

12001

DUPLICATE_RECORD

409

Запис вже існує.Чи не возвращается Auth API v2.

12002

VALIDATION_ERROR

400

Недійсні входи.Може буті повернуто, если запит неправильно відформатованій як JSON.

12003

INVALID_REQUEST

400

Невірний запит.Чи не возвращается Auth API v2.

12004

CONCURRENCY_FAILURE

409

Чи не вдалося оновити вузол.Чи не возвращается Auth API v2.

12005

ACCESS_DENIED

401

В доступі відмовлено.Перегляньте докладні Відомості про помилки, щоб докладніше дізнатіся, чому в доступі Було Відмовлено.

12006

METHOD_NOT_SUPPORTED

405

HTTP-метод запиту не підтримується.Чи не возвращается Auth API v2

12007

INTERNAL_SERVER_ERROR

500

Внутрішня помилка сервера.У ActiveServer став внутрішня помилка сервера, можливо, через Деяк проблем з конфігурацією або установкою. Будь ласка, зверніться до Опису помилки для більш докладної информации.

12008

DATA_INTEGRITY_VIOLATION_ERROR

400

Вказане значення порушує обмеження цілісності. Може статися, якщо спроба вставити оновлення призводить до порушення обмеження цілісності. Наприклад, унікальні первинні ключі не вставляти в таблицю.Чи не возвращается Auth API v2

12009

SESSION_TIMED_OUT408Час сеансу минув.Може буті повернути, если транзакція Вже завершена.


4. Коди помилок безпеки (13001 ~ 13024)


Код

Назва

HTTP Status код

Опис

13001JDK_NOT_SUPPORT_SHA224WITHRSA500Використовуваний JDK не підтримує SHA224 з алгоритмом RSA.
13002NO_SUCH_ALGORITHM500Такого алгоритму немає.
13003INVALID_CERT400Відкритий ключ сертифіката несумісний з відповідним закритим ключем.
13004INVALID_CHAIN400ActiveServer не може побудувати повний ланцюжок сертифікатів, так як один або кілька проміжних сертифікатів не можуть бути знайдені в сховище сертифікатів ЦС. Ви повинні або встановити / імпортувати сертифікат, який містить повний ланцюжок, або встановити відсутні проміжні сертифікати перед повторною спробою.
13005NO_PRIVATE_KEY_FOUND400Закритий ключ не знайдений.
13006INVALID_CERTIFICATE_CONTENT400Недійсне вміст сертифікату
13007CERTIFICATE_IO_READ400Неможливо прочитати сертифікат.
13008SUCH_PROVIDER_EXCEPTION500Немає такого виключення постачальника.
13009NO_KEY400Сертифікат не може бути встановлений, оскільки у цього об'єкта немає існуючого ключа.
13010CERTIFICATE_CHAIN_BAD_FORMAT400Ланцюжок сертифікатів має неприпустимий формат.
13011MISMATCHED_PASSWORDS400Поля пароля не збігаються.
13012IMPORT_CERTIFICATE400Сертифікат для імпортує сертифіката не найден. Імпорт сертифікат клієнта.
13013IMPORT_NO_CERTIFICATE400Сертифіката для експорту немає.
13014FAILED_TO_INITIALIZE500Неможливо ініціалізувати.
13015ENCRYPTION_FAIL500Чи не вдалося зашифрувати.
13016DECRYPTION_FAIL500Чи не вдалося розшифрувати.
13017INVALID_HSM_PROVIDER500Зазначене ім'я постачальника для апаратного шифрування не підтримується.
13018INVALID_PKCS11_CONFIG500Невірний шлях конфігурації PKCS11
13019FAILED_TO_INITIALIZE_PKCS11500Неможливо ініціалізувати PKCS11.
13020IMPORT_FAIL500Неможливо імпортувати.
13021NOT_SUPPORTED_IBM_PROVIDER500Підтримується тільки провайдер SUN.
13022UNABLE_TO_LOAD_KEYSTORE500Не вдалося завантажити сховище ключів.
13023UNABLE_TO_LOAD_CERTIFICATE500Не вдалося завантажити сертифікат.
13024INVALID_KEY_SIZE500Невірний розмір ключа.



5. Коди помилок користувача (14000 ~ 14022)


Код

Назва

HTTP Status код

Опис

14000DUPLICATE_EMAIL400Ця електронна адреса вже зайнятий.
14001LAST_ADMIN_DELETE_NOT_ALLOWED400Для виконання цієї дії ви повинні бути як мінімум користувачем системного адміністратора.
14002ACCOUNT_IS_LOCKED401Ваш аккаунт заблокований.
14003ACCOUNT_IS_DISABLED401Ваш обліковий запис відключена.
14004ACCOUNT_WILL_BE_LOCKED401Ваш обліковий запис буде заблокована після ще однієї невдалої спроби. Якщо ви забули пароль, натисніть «Забули пароль».
14005ACCOUNT_WAS_LOCKED401Пароль заблокований на 1 годину.
14006ACCOUNT_IS_INACTIVE401Ваш обліковий запис не була активована.
14007PASSWORD_POLICY_MATCH401Пароль повинен складатися мінімум з восьми символів, по крайней мере, з однієї літери і однієї цифри.
14008LOGIN_ALREADY_IN_USE401Ім'я користувача вже використовується.
14009EMAIL_ALREADY_IN_USE401Ця електронна адреса вже зайнятий.
14010INVALID_TOTP_CODE400Недійсний код аутентифікації Totp.
14011EMAIL_SENDING_FAILED400Чи не вдалося відправити електронний лист.
14012EMAIL_NOT_REGISTERED400Вашу адресу електронної пошти не зареєстрований.
14014FAILED_TO_CREATE_ACCOUNT500Не вдалося створити обліковий запис.
14015TWO_FA_MANDATORY400Використання двухфакторного входу в систему обов'язково.
14016PASSWORD_EXPIRED403Термін дії пароля користувача минув.
14017PASSWORD_EXPIRED_WARNING403Термін дії пароля користувача закінчиться.
14018PASSWORD_HISTORY_MATCHED403Пароль збігся з попередніми історичними паролями.
14019INVALID_TOKEN400Недійсний токен.
14020INVALID_HSM_PIN400Недійсний PIN-код HSM.
14021INVALID_PASSWORD400Неправильний пароль.
14022EMAIL_INVALID_ACTIVATION403Код активації облікового запису недійсний.



6. Код помилок установки (15000)


15000SETUP_NOT_ALLOWED500Налаштування не дозволена

На цій сторінці:

  • No labels