---
title: "Одностадийная оплата по криптограмме"
method: POST
path: "/payments/cards/charge"
tags: ["Payments"]
---

# Одностадийная оплата по криптограмме

`POST /payments/cards/charge`

Одностадийная оплата по криптограмме

Выполняет оплату в одну стадию - авторизация и списание происходят одновременно.
При необходимости 3-D Secure аутентификации возвращает данные для перенаправления на ACS.

## Request body

- CryptogramPaymentRequest — Запрос на оплату по криптограмме
  - `Amount` number, double, required — Сумма платежа (до 2 знаков после точки)
  - `Currency` string — Валюта (RUB по умолчанию)
  - `IpAddress` string, required — IP-адрес плательщика
  - `CardCryptogramPacket` string, required — Криптограмма платежных данных
  - `Name` string — Имя держателя карты (латиница)
  - `PaymentUrl` string — URL сайта, с которого выполняется оплата
  - `InvoiceId` string — Номер заказа
  - `Description` string — Описание платежа
  - `CultureName` string — Язык уведомлений (ru-RU, en-US)
  - `AccountId` string — Идентификатор пользователя
  - `Email` string — Email плательщика
  - `Payer` Payer — Информация о плательщике
    - `FirstName` string — Имя
    - `LastName` string — Фамилия
    - `MiddleName` string — Отчество
    - `Birth` string — Дата рождения (YYYY-MM-DD)
    - `Street` string — Улица
    - `Address` string — Адрес
    - `City` string — Город
    - `Country` string — Страна (код ISO)
    - `Phone` string — Телефон
    - `Postcode` string — Почтовый индекс
  - `JsonData` object — Дополнительные данные (JSON)
  - `SaveCard` boolean — Сохранить токен карты для повторных платежей

## Response `200`

The request has succeeded.

- union
  - object — Базовый ответ API
    - `Success` boolean, required — Результат выполнения запроса
    - `Message` string — Описание ошибки (при наличии)
    - `Model` TransactionModel — Модель транзакции в ответе API
      - `ReasonCode` integer, required — Код причины отклонения (0 = успех)
      - `PublicId` string, required — Public ID терминала
      - `TerminalUrl` string, required — URL терминала
      - `TransactionId` integer, required — Номер транзакции
      - `Amount` number, double, required — Сумма платежа
      - `Currency` string, required — Валюта платежа
      - `CurrencyCode` integer, required — Код валюты
      - `PaymentAmount` number, double, required — Сумма платежа в валюте оплаты
      - `PaymentCurrency` string, required — Валюта оплаты
      - `PaymentCurrencyCode` integer, required — Код валюты оплаты
      - `InvoiceId` string — Номер заказа
      - `AccountId` string — Идентификатор пользователя
      - `Email` string — Email плательщика
      - `Description` string — Описание платежа
      - `JsonData` string — Дополнительные данные JSON
      - `CreatedDate` string, required — Дата создания (формат /Date(...)/)
      - `PayoutDate` string — Дата выплаты
      - `PayoutDateIso` string — Дата выплаты ISO
      - `PayoutAmount` number, double — Сумма выплаты
      - `CreatedDateIso` string, required — Дата создания ISO
      - `AuthDate` string — Дата авторизации
      - `AuthDateIso` string — Дата авторизации ISO
      - `ConfirmDate` string — Дата подтверждения
      - `ConfirmDateIso` string — Дата подтверждения ISO
      - `AuthCode` string — Код авторизации
      - `TestMode` boolean, required — Режим тестирования
      - `Rrn` string — Retrieval Reference Number
      - `OriginalTransactionId` integer — ID оригинальной транзакции
      - `FallBackScenarioDeclinedTransactionId` integer — ID отклоненной транзакции fallback сценария
      - `IpAddress` string, required — IP-адрес плательщика
      - `IpCountry` string, required — Страна по IP
      - `IpCity` string — Город по IP
      - `IpRegion` string — Регион по IP
      - `IpDistrict` string — Округ по IP
      - `IpLatitude` number, double — Широта по IP
      - `IpLongitude` number, double — Долгота по IP
      - `CardFirstSix` string, required — Первые 6 цифр карты
      - `CardLastFour` string, required — Последние 4 цифры карты
      - `CardExpDate` string, required — Срок действия карты
      - `CardType` string, required — Тип карты (Visa, MasterCard, etc.)
      - `CardProduct` string — Продукт карты
      - `CardCategory` string — Категория карты
      - `EscrowAccumulationId` string — ID накопления для безопасной сделки
      - `IssuerBankCountry` string, required — Страна банка-эмитента
      - `Issuer` string, required — Банк-эмитент
      - `CardTypeCode` integer, required — Код типа карты
      - `Status` string, required — Статус транзакции (текст)
      - `StatusCode` integer, required — Код статуса транзакции
      - `CultureName` string, required — Язык
      - `Reason` string, required — Причина (текст)
      - `CardHolderMessage` string, required — Сообщение для держателя карты
      - `Type` integer, required — Тип операции
      - `Refunded` boolean, required — Признак возврата
      - `Name` string — Имя держателя карты
      - `Token` string — Токен карты для повторных платежей
      - `SubscriptionId` string — ID подписки
      - `GatewayName` string, required — Имя шлюза
      - `AndroidPay` boolean, required — Признак Android Pay
      - `WalletType` string, required — Тип кошелька
      - `TotalFee` number, double, required — Общая комиссия
  - object — Базовый ответ API
    - `Success` boolean, required — Результат выполнения запроса
    - `Message` string — Описание ошибки (при наличии)
    - `Model` ThreeDsRequiredModel — Модель ответа, требующего 3-D Secure аутентификацию
      - `TransactionId` integer, required — ID транзакции (используется как MD)
      - `PaReq` string, required — Параметр PaReq для ACS
      - `GoReq` string — Параметр GoReq (опционально)
      - `AcsUrl` string, required — URL сервера аутентификации (ACS)
      - `ThreeDsSessionData` string — Данные сессии 3DS
      - `IFrameIsAllowed` boolean, required — Разрешено ли использовать iframe
      - `FrameWidth` integer — Ширина фрейма
      - `FrameHeight` integer — Высота фрейма
      - `ThreeDsCallbackId` string, required — ID callback для 3DS
      - `EscrowAccumulationId` string — ID накопления для безопасной сделки

---

[API](https://skmtc.net/hexlet/apis/cloudpayments-api.md) · [All operations](https://skmtc.net/hexlet/apis/cloudpayments-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/hexlet/cloudpayments-api/versions/737bf804f9ef/schema)