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

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

---

Запрос

Для списания средств отправьте POST запрос на https://processing.ecomcharge.com/transactions/captures со следующими параметрами:

Параметр	Тип	Описание
parent_uid * обязательный	string	UID транзакции авторизации.
amount * обязательный	bigInteger	Сумма списания в минимальных денежных единицах, например 1000 для $10.00.
duplicate_check	boolean	Параметр управляет процессом проверки входящего запроса на уникальность. Если true, то повторный запрос на списание средств с таким же amount и parent_uid, отправленный в течение 30 секунд после первого запроса, будет отклонен. По умолчанию, этот параметр имеет значение true.

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

{
  "request":{
    "parent_uid":"1-310b0da80b",
    "amount":50
  }
}

Ответ

Параметр	Тип	Описание
transaction * обязательный	object
uid * обязательный	string	UID обработанной транзакции.
status * обязательный	string	Статус обработанной транзакции.
message * обязательный	string	Сообщение с результатом запроса.
type * обязательный	string	Тип транзакции.
receipt_url * обязательный	string	Ссылка на квитанцию по транзакции обработанной транзакции.
code * обязательный	string	Код обработки транзакции.
friendly_message * обязательный	string	Сообщение для покупателя с описанием кода ошибки из параметра code.
be_protected_verification	object	Секция с параметрами проверки beProtected.

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

{
    "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://gateway.ecomcharge.com/customer/transactions/52bfc29a-2c2f-408a-a7d5-bd8e84a320a9/580262bb7b11a467fd85aa1c22f3c4afb4150511533c086b55eb7e53f81f4727?language=en",
        "status_code": null,
        "mute_notifications": null,
        "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"
        }
    }
}

Пример ответа транзакции, не прошедшей beProtected проверку

{
  "transaction":{
    "be_protected_verification":{
      "status":"failed",
      "message":"Merchant terminal limits exceeded (maximum transaction amount). Transaction didn't pass anti-fraud checks.",
      "limit":{
        "volume":false,
        "count":false,
        "max":true,
        "current_volume":100,
        "current_count":1
      },
      "white_black_list":{
        "card_number":"black",
        "ip":"absent",
        "email":"absent"
      },
      "rules":{
        "1_123_My Shop":{
          "more_100_eur" : {"Transaction amount more than 100 AND Transaction currency is EUR": "passed"}
        },
        "1_John Doe":{},
        "eComCharge":{}
      }
    },
    "uid":"2-310b0da80b",
    "status":"failed",
    "message":"Merchant terminal limits exceeded (maximum transaction amount). Transaction didn't pass anti-fraud checks.",
    "amount":50,
    "parent_uid":"1-310b0da80b",
    "receipt_url": "https://gateway.ecomcharge.com/customer/transactions/2-310b0da80b/11443f39ae75aa1f955a9c9283cd5045bfb0413b65d666f834a9da4e7d3926b5",
    "currency":"USD",
    "type":"capture",
    "test":false
  }
}

Пример ответа транзакции, успешно прошедшей beProtected проверку

{
  "transaction":{
    "capture":{
      "message":"The operation was successfully processed.",
      "ref_id":"8889999",
      "gateway_id":152,
      "status":"successful"
    },
    "be_protected_verification":{
      "status":"successful",
      "limit":{
        "volume":false,
        "count":false,
        "max":false,
        "current_volume":90,
        "current_count":1
      },
      "white_black_list":{
        "card_number":"absent",
        "ip":"absent",
        "email":"absent"
      },
      "rules":{
        "1_123_My Shop":{
          "more_100_eur" : {"Transaction amount more than 100 AND Transaction currency is EUR": "passed"}
        },
        "1_John Doe":{},
        "eComCharge":{}
      }
    },
    "uid":"2-310b0da80b",
    "status":"successful",
    "message":"Successfully processed",
    "amount":50,
    "parent_uid":"1-310b0da80b",
    "receipt_url": "https://gateway.ecomcharge.com/customer/transactions/2-310b0da80b/11443f39ae75aa1f955a9c9283cd5045bfb0413b65d666f834a9da4e7d3926b5",
    "currency":"USD",
    "type":"capture",
    "test":false
  }
}