Перейти к основному содержимому

Справочники

Причины отклонения операции​

Общий вид статуса отклонённой операции:

"status": {
  "value": "DECLINED",
  "changedDateTime": "2099-01-01T12:34:56Z",

  "reasonSource": <Источник причины отклонения операции>,
  "reasonCode": <Коды причины отклонения операции>,
  "reasonMessage": "Какое-либо пояснение причины отклонения",

  ...
}

Источники причины отклонения в проведении операции:

  • PROCESSING - платежный процессинг;
  • ACQUIRER - шлюз - эквайрер;
  • PAY_SYSTEM - платежная система;
  • ISSUER - эмитент, выпустивший карту;
  • MPI - в процессе проведения 3DS;
  • FRAUD - служба фрод-мониторинга.

Коды причины отклонения операции:

  • INTERNAL_ERROR - ошибка в бизнес-логике;
  • TECH_ERROR - общая техническая ошибка;
  • LIMIT_EXCEEDED - достигнут один из лимитов (оборот, кол-во операции и так далее);
  • OPERATION_NOT_SUPPORTED - операция не поддерживается на стороне источника;
  • PAYMENT_NOT_FOUND - не найдена исходная операция списания средств;
  • INVALID_CARD - в запросе передана некорректная карта;
  • EXPIRED_CARD - срок действия карты завершен;
  • NOT_PERMITTED - проведение операции запрещено;
  • INTEGRATION_ERROR - ошибка в интеграции с внешним эквайрером;
  • VALIDATION_ERROR - запрос не прошел проверку;
  • INCORRECT_TRANSACTION_STATE - попытка перевести операцию в некорректное состояние;
  • INCORRECT_AMOUNT - в запросе передана некорректная сумма;
  • TOO_MANY_REQUESTS - сработало ораничение на число запросов к процессингу;
  • ISSUER_NOT_AVAILABLE - эмитент не доступен по техническим причинам;
  • REATTEMPT_NOT_PERMITTED - повторение операции запрещено правилами платежной системы;
  • INSUFFICIENT_FUNDS - недостаточно средств на счете клиента;
  • BLOCKED_CARD - карта заблокирована;
  • INCORRECT_CVV - передан некорректный cvv код;
  • EXPIRED_3DS - 3DS не был завершен вовремя;
  • SUSPECTED_FRAUD - операция отклонена из-за подозрения в мошенничестве.

Статусы и коды ошибок​

Общий вид ответа:

{
  "code": <HTTP_STATUS>,
  "id":"4a0f8085-c255-4693-8f1e-68a5e4b0adb7",
  "message": <Категория ошибки>,
  "Errors":[
    {
        "errorCode": <Подкатегория ошибки>,
        "message":"Более детальное пояснение проблемы",
        "url":"https://enter.tochka.com/uapi/pay"
    }
  ]
}

Бывает, что формат ответа отличается от представленного выше. В таком случае нужно повторить операцию. Если при повторной операции проблема сохранится, обратитесь в поддержку Точки.

Описание возможных вариантов параметров ответа:

400 (HTTP_STATUS)

  • REQUEST_PARSING_ERROR (Категория)
  • REQUEST_VALIDATION_ERROR (Категория)

401 (HTTP_STATUS)

  • INVALID_TOKEN (Категория)
    • UNKNOWN_TOKEN (Подкатегория)
    • TOKEN_EXPIRED (Подкатегория)
    • INCORRECT_FORMAT (Подкатегория)

403 (HTTP_STATUS)

  • OPERATION_FORBIDDEN (Категория)
    • SIGNATURE_VERIFICATION_ERROR (Подкатегория)
    • UNAUTHORIZED_BY_TOKEN (Подкатегория)
    • FEATURE_DISABLED_FOR_MERCHANT_SITE (Подкатегория)

404 (HTTP_STATUS)

  • ENTITY_NOT_FOUND (Категория)
    • MERCHANT_NOT_FOUND (Подкатегория)
    • MERCHANT_SITE_NOT_FOUND (Подкатегория)
    • PAYMENT_NOT_FOUND (Подкатегория)

423 (HTTP_STATUS)

  • OPERATION_LOCKED (Категория)
    • PAYMENT_LOCKED (Подкатегория)

429 (HTTP_STATUS)

  • OPERATION_RATE_LIMIT (Категория)

500 (HTTP_STATUS)

  • INTERNAL_ERROR (Категория)
    • CARD_PROCESSING_ERROR (Подкатегория)

501 (HTTP_STATUS)

  • UNSUPPORTED_OPERATION (Категория)
    • NOT_SUPPORTED_BY_PROCESSING (Подкатегория)
    • UNSUPPORTED_PAYMENT_METHOD (Подкатегория)

503 (HTTP_STATUS)

  • UNDERLYING_SERVICE_UNAVAILABLE (Категория)
    • CONNECTION_BROKEN (Подкатегория)
    • CONNECTION_TIMEOUT (Подкатегория)