Справочники
Коды ошибок
Ниже предоставлены коды ошибок, которые определяют причину отказа в проведении платежа.
Код возвращается в Fail уведомлении и при оплате через API.
Сообщение для плательщика виджет показывает самостоятельно, а в API за него отвечает параметр CardHolderMessage.
| Код | Название | Причина | Сообщение для плательщика |
| 5001 | Refer To Card Issuer | Отказ эмитента проводить онлайн операцию | Свяжитесь с вашим банком или воспользуйтесь другой картой |
| 5005 | Do Not Honor |
Отказ эмитента без объяснения причин Данный код возвращается по следующим причинам: — неверно указан код CVV на картах MasterCard; — внутренние ограничения банка, выпустившего карту; — карта заблокирована или еще не активирована; — на карте не включены интернет-платежи или не подключен 3DS. |
Свяжитесь с вашим банком или воспользуйтесь другой картой |
| 5006 | Error | Отказ сети проводить операцию или неправильный CVV код | Проверьте правильность введенных данных карты или воспользуйтесь другой картой |
| 5012 | Invalid Transaction | Карта не предназначена для онлайн платежей | Воспользуйтесь другой картой или свяжитесь с банком, выпустившим карту |
| 5013 | Amount Error | Слишком маленькая или слишком большая сумма операции | Проверьте корректность суммы |
| 5030 | Format Error | Ошибка на стороне эквайера — неверно сформирована транзакция | Повторите попытку позже |
| 5031 | Bank Not Supported By Switch | Неизвестный эмитент карты | Воспользуйтесь другой картой |
| 5034 | Suspected Fraud | Отказ эмитента — подозрение на мошенничество | Свяжитесь с вашим банком или воспользуйтесь другой картой |
| 5041 | Lost Card | Карта потеряна | Свяжитесь с вашим банком или воспользуйтесь другой картой |
| 5043 | Stolen Card | Карта украдена | Свяжитесь с вашим банком или воспользуйтесь другой картой |
| 5051 | Insufficient Funds | Недостаточно средств | Недостаточно средств на карте |
| 5054 | Expired Card | Карта просрочена или неверно указан срок действия | Проверьте правильность введенных данных карты или воспользуйтесь другой картой |
| 5057 | Transaction Not Permitted |
Ограничение на карте Данный код возвращается по следующим причинам: — внутренние ограничения банка, выпустившего карту; — карта заблокирована или еще не активирована; — на карте не включены интернет-платежи или не подключен 3DS. |
Свяжитесь с вашим банком или воспользуйтесь другой картой |
| 5065 | Exceed Withdrawal Frequency | Превышен лимит операций по карте | Свяжитесь с вашим банком или воспользуйтесь другой картой |
| 5082 | Incorrect CVV | Неверный CVV код | Неверно указан код CVV |
| 5091 | Timeout | Эмитент недоступен | Повторите попытку позже или воспользуйтесь другой картой |
| 5092 | Cannot Reach Network | Эмитент недоступен | Повторите попытку позже или воспользуйтесь другой картой |
| 5096 | System Error | Ошибка банка-эквайера или сети | Повторите попытку позже |
| 5204 | Unable To Process | Операция не может быть обработана по прочим причинам | Свяжитесь с вашим банком или воспользуйтесь другой картой |
| 5206 | Authentication failed | 3-D Secure авторизация не пройдена | Свяжитесь с вашим банком или воспользуйтесь другой картой |
| 5207 | Authentication unavailable | 3-D Secure авторизация недоступна | Свяжитесь с вашим банком или воспользуйтесь другой картой |
| 5300 | Anti Fraud | Лимиты эквайера на проведение операций | Воспользуйтесь другой картой |
Статусы операций
В таблице ниже представлены статусы транзакций, условия применения и возможные действия.
| Статус | Описание | Применение | Возможные действия |
| AwaitingAuthentication | Ожидает аутентификации | После перехода плательщика на сайт эмитента в ожидании результатов 3-D Secure | Нет |
| Authorized | Авторизована | После получения авторизации | Подтверждение, Отмена |
| Completed | Завершена | После подтверждения операции | Возврат денег |
| Cancelled | Отменена | В случае отмены операции | Нет |
| Declined | Отклонена | В случае невозможности провести операцию (нет денег на счете карты и т.п.) | Нет |
Статусы подписок (рекуррент)
В таблице ниже представлены статусы подписок, условия применения и возможные действия.
| Статус | Описание | Применение | Возможные действия |
| Active | Подписка активна | После создания и очередной успешной оплаты | Отмена |
| PastDue | Просрочена | После одной или двух подряд неуспешных попыток оплаты | Отмена |
| Cancelled | Отменена | В случае отмены по запросу | Нет |
| Rejected | Отклонена | В случае трех неудачных попыток оплаты, идущих подряд | Нет |
| Expired | Завершена | В случае завершения максимального количества периодов (если были указаны) | Нет |
Список валют
Наши партнеры принимают платежи в рублях, американских долларах, евро, фунтах стерлингов и 54 других валютах мира.
В таблице ниже представлены названия валют и их коды для использования в параметре currency виджета или API.
| Название | Код |
| Казахский тенге | KZT |
| Российский рубль | RUB |
| Евро | EUR |
| Доллар США | USD |
| Фунт стерлингов | GBP |
| Украинская гривна | UAH |
| Белорусский рубль (не используется с 1 июля 2016) | BYR |
| Белорусский рубль | BYN |
| Азербайджанский манат | AZN |
| Швейцарский франк | CHF |
| Чешская крона | CZK |
| Канадский доллар | CAD |
| Польский злотый | PLN |
| Шведская крона | SEK |
| Турецкая лира | TRY |
| Китайский юань | CNY |
| Индийская рупия | INR |
| Бразильский реал | BRL |
| Южноафриканский рэнд | ZAL |
| Узбекский сум | UZS |
Российским юридическим лицам и индивидуальным предпринимателям, намеревающимся принимать платежи в валюте, необходимо согласовать желаемый список валют на этапе подключения.
Если необходимой вам валюты нет в списке, напишите нам на support@cloudpayments.kz и мы его обновим.
Коды временных зон
В таблице ниже представлены коды временных зон для преобразования времени.
| Код | Название |
| HST | (UTC-10:00) Гавайи |
| AKST | (UTC-09:00) Аляска |
| PST | (UTC-08:00) Тихоокеанское время (США и Канада) |
| MST | (UTC-07:00) Горное время (США и Канада) |
| CST | (UTC-06:00) Центральное время (США и Канада) |
| EST | (UTC-05:00) Восточное время (США и Канада) |
| AST | (UTC-04:00) Атлантическое время (Канада) |
| BRT | (UTC-03:00) Бразилия |
| UTC | (UTC) Время в формате UTC |
| GMT | (UTC) Дублин, Лиссабон, Лондон, Эдинбург |
| CET | (UTC+01:00) Амстердам, Берлин, Берн, Вена, Рим, Стокгольм |
| CET | (UTC+01:00) Белград, Братислава, Будапешт, Любляна, Прага |
| CET | (UTC+01:00) Брюссель, Копенгаген, Мадрид, Париж |
| CET | (UTC+01:00) Варшава, Загреб, Сараево, Скопье |
| EET | (UTC+02:00) Афины, Бухарест |
| EET | (UTC+02:00) Вильнюс, Киев, Рига, София, Таллин, Хельсинки |
| EET | (UTC+02:00) Восточная Европа |
| EET | (UTC+02:00) Калининград (RTZ 1) |
| MSK | (UTC+03:00) Волгоград, Москва, Санкт-Петербург (RTZ 2) |
| MSK | (UTC+03:00) Минск |
| AZT | (UTC+04:00) Баку |
| AMT | (UTC+04:00) Ереван |
| SAMT | (UTC+04:00) Ижевск, Самара (RTZ 3) |
| GET | (UTC+04:00) Тбилиси |
| TJT | (UTC+05:00) Ашхабад, Ташкент |
| YEKT | (UTC+05:00) Екатеринбург (RTZ 4) |
| ALMT | (UTC+06:00) Астана, Алматы |
| NOVT | (UTC+06:00) Новосибирск (RTZ 5) |
| KRAT | (UTC+07:00) Красноярск (RTZ 6) |
| HKT | (UTC+08:00) Гонконг, Пекин, Урумчи, Чунцин |
| IRKT | (UTC+08:00) Иркутск (RTZ 7) |
| SGT | (UTC+08:00) Куала-Лумпур, Сингапур |
| ULAT | (UTC+08:00) Улан-Батор |
| YAKT | (UTC+09:00) Якутск (RTZ 8) |
| VLAT | (UTC+10:00) Владивосток, Магадан (RTZ 9) |
| SAKT | (UTC+11:00) Чокурдах (RTZ 10) |
| ANAT | (UTC+12:00) Анадырь, Петропавловск-Камчатский (RTZ 11) |