Списание средств

Данная транзакция списывает средства, ранее зарезервированные транзакцией авторизации, и деньги поступают на расчётный счёт торговца в сроки, оговоренные в договоре на приём платежа по банковским картам.

Запрос

Для списания средств отправьте POST запрос на https://gateway.mfstream.io/transactions/captures с параметрами из таблиц ниже.

Параметры заголовка запроса


Content-Type обязательный	`application/json`
Accept обязательный	`application/json`
X-API-Version	Возможные значения: `2`, `3`. По умолчанию, `3`. Подробнее здесь
RequestID	Ключ идемпотентности. Подробнее здесь.

Параметры тела запроса

object

parent_uid

обязательный

string
UID транзакции авторизации.

amount

обязательный

bigInteger
Сумма списания в минимальных денежных единицах, например 1000 для $10.00.

tracking_id

string (255)
ID транзакции или заказа в вашей системе. Пожалуйста, используйте уникальное значение для того, чтобы при запросе статуса транзакции получить актуальную информацию. В противном случае вы получите массив данных по 10 последним транзакциям, найденным по указанному tracking_id. В параметре может быть отправлено несколько значений, разделенных символом ;. Например: "cbe59142-90af-4aea-b5a5-5bf3f66cf3da;f7883cb9-0e26-43a7-beb7-4027cb55d1a6;4a6a89d5-6950-400f". Если в запросе было передано более одного значения tracking_id, поиск транзакции в личном кабинете может быть осуществлен по любому из них. Если tracking_id не передан, в ответе возвращается tracking_id соответствующей транзакции авторизации при условии, что параметр был передан в запросе на авторизацию.

object
Секция, содержащая дополнительную информацию о транзакции.

referer

string
URL ресурса, с которого осуществляется запрос на проведение транзакции. Уточните у службы технической поддержки, является ли этот параметр обязательным для вашего эквайера.

Warning

Если интеграция поддерживает несколько частичных списаний для одной транзакции авторизации, каждый запрос на списание рассматривается как отдельная транзакция.

Если после отправки запроса получен ответ 5xx или произошла сетевая ошибка, рекомендуется проверить статус транзакции по tracking_id. Если транзакция не найдена, повторите исходный запрос с тем же ключом идемпотентности.

Повторный запрос без ключа идемпотентности или с новым ключом идемпотентноти может привести к созданию дополнительного списания.

Пример запроса

{
  "request": {
    "parent_uid": "1-310b0da80b",
    "amount": 50,
    "tracking_id": "tracking_id_2",
    "additional_data": {
      "referer": "https://example.com/server/cs_post/post.php?order_id=5304380&security=949247&currency=USD"
    }
  }
}

Ответ

object

uid

обязательный

string
UID обработанной транзакции.

tracking_id

обязательный

string
Значение параметра tracking_id из запроса. Если tracking_id не был передан в запросе списания средств, но был передан в соответствующем запросе авторизации, в ответе возвращается tracking_id соответствующей транзакции авторизации.

status

обязательный

string
Статус обработанной транзакции.

message

обязательный

string
Сообщение о результате обработки запроса, соответствующее коду результата обработки транзакции (code). Для отдельных вариантов интеграции данный параметр содержит сообщение от системы эквайера.

type

обязательный

string
Тип транзакции.

receipt_url

обязательный

string
Ссылка на квитанцию по транзакции обработанной транзакции.

object
Секция, содержащая дополнительную информацию о транзакции.

referer

string
URL ресурса, с которого осуществляется запрос на проведение транзакции.

object
Секция с данными о прохождении проверок транзакции сервисом Умная Маршрутизация.

status

string
Статус обработки транзакции сервисом.

object

message	string Сообщение от системы банка.
ref_id	string Номер транзакции в системе банка.
rrn	string Номер транзакции в международной платёжной системе. ID транзакции, выданный сетью обработки карт.
auth_code	string Код авторизации.
gateway_id	string Идентификатор платёжного шлюза, который обработал транзакцию, в системе MF STREAM.
status	string Статус обработанной транзакции.

code

обязательный

string
Код обработки транзакции.

friendly_message

обязательный

string
Сообщение о результате обработки запроса для покупателя, соответствующее коду результата обработки транзакции (code). Для отдельных вариантов интеграции данный параметр содержит сообщение от системы эквайера.

Пример ответа

{
    "transaction": {
        "uid": "52bfc29a-2c2f-408a-a7d5-bd8e84a320a9",
        "status": "successful",
        "amount": 460,
        "currency": "EUR",
        "type": "capture",
        "message": "Successfully processed",
        "test": true,
        "created_at": "2024-04-02T12:07:14.881Z",
        "updated_at": "2024-04-02T12:07:20.028Z",
        "paid_at": "2024-04-02T12:07:19.955Z",
        "closed_at": null,
        "settled_at": null,
        "manually_corrected_at": null,
        "parent_uid": "4298aabd-9547-46fa-a151-66c29489c157",
        "receipt_url": "https://backoffice.mfstream.io/customer/transactions/52bfc29a-2c2f-408a-a7d5-bd8e84a320a9/580262bb7b11a467fd85aa1c22f3c4afb4150511533c086b55eb7e53f81f4727?language=en",
        "status_code": null,
        "mute_notifications": null,
        "tracking_id": "tracking_id_2",
        "id": "52bfc29a-2c2f-408a-a7d5-bd8e84a320a9",
        "code": "S.0000",
        "friendly_message": "The operation is successful.",
        "smart_routing_verification": {
            "status": "successful"
        },       
        "capture": {
            "message": "Capture was approved",
            "ref_id": "8889912",
            "rrn": null,
            "auth_code": null,
            "bank_code": "05",
            "gateway_id": 3483,
            "status": "successful"
        },
        "additional_data": {
          "referer": "https://example.com/server/cs_post/post.php?order_id=5304380&security=949247&currency=USD"
        }
    }
}