Перейти к содержанию

Проверка

Проверяет данные транзакции в соответствии с правилами: white и black списки, величина лимитов, лимит по скорости и обработка ограничений (например, блокировка карт с определенными BIN).


Запрос

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

Параметр Тип Описание
amount * обязательный
integer Стоимость в минимальных денежных единицах. Например, $32.45 должна быть отправлена как 3245.
currency * обязательный
string Валюта в ISO-4217 формате, например USD.
description * обязательный
string (255) Описание заказа.
tracking_id * обязательный
string (255) ID транзакции или заказа в вашей системе. Пожалуйста, используйте уникальное значение для того, чтобы при запросе статуса транзакции получить актуальную информацию. В противном случае вы получите первую найденную по tracking_id транзакцию. В параметре может быть отправлено несколько значений, разделенных символом ;. Например: "cbe59142-90af-4aea-b5a5-5bf3f66cf3da;f7883cb9-0e26-43a7-beb7-4027cb55d1a6;4a6a89d5-6950-400f". Если в запросе было передано более одного значения tracking_id, поиск транзакции в личном кабинете может быть осуществлен по любому из них.
duplicate_check boolean Параметр управляет процессом проверки входящего запроса на уникальность. Если в течение 30 секунд придет запрос на проверку с одинаковыми amount и number или token, то запрос будет отклонен. По умолчанию, этот параметр имеет значение true.
language string Язык страницы оформления заказа.

Если параметр установлен и email уведомление о транзакции включено, eComCharge отправит email, локалью которого будет language. По умолчанию - en. Доступные значения параметра language.
notification_url string URL, на который будут приходить уведомления. Формат запроса уведомления аналогичен формату ответа транзакции.
verification_url string URL, на который будут приходить запрос на подтверждение транзакции. Формат запроса на подтверждение аналогичен формату ответа транзакции.
test boolean Транзакция тестовая, если значение true.
credit_card object
number * обязательный
string (19) Номер карты.
holder * обязательный
string (32) Имя владельца карты.
exp_month * обязательный
integer Месяц окончания срока действия карты, представленный двумя цифрами (например, 01).
exp_year * обязательный
integer Год срока окончания действия карты, представленный четырьмя цифрами (например, 2026).
token * условно обязательный
string Вместо 5 параметров выше вы можете отправить токен карты, который вы получили в ответе первой оплаты.
customer * условно обязательный
object Секция информации о покупателе.
Уточните у Службы технической поддержки, необходимо ли передавать параметры данной секции.
ip string IP-адрес клиента, производящего оплату в вашем магазине.
email string email клиента, производящего оплату в вашем магазине.
billing_address object
first_name * условно обязательный
string (30) Имя клиента.
last_name * условно обязательный
string (30) Фамилия клиента.
country * условно обязательный
string Страна клиента в ISO 3166-1 alpha-2 формате.
city * условно обязательный
string (60) Город клиента. Максимальная длина: 60 символов.
state * условно обязательный
string Двухбуквенная абревиатура штата, если страна клиента US или CA.
zip string Почтовый индекс клиента. Для country=US, формат почтового индекса должен иметь вид NNNNN или NNNNN-NNNN.
address * условно обязательный
string (255) Адрес клиента.
phone * условно обязательный
string (100) Номер телефона клиента.
Пример запроса
{
  "request":{
      "amount":100,
      "currency":"USD",
      "description":"Test transaction",
      "tracking_id":"your_uniq_number",
      "language":"en",
      "billing_address":{
        "first_name":"John",
        "last_name":"Doe",
        "country":"US",
        "city":"Denver",
        "state":"CO",
        "zip":"96002",
        "address":"1st Street"
      },
      "credit_card":{
        "number":"4200000000000000",
        "holder":"John Doe",
        "exp_month":"05",
        "exp_year":"2026"
      },
      "customer":{
        "ip":"127.0.0.1",
        "email":"john@example.com"
      }
  }
}
Пример запроса с токеном карты
{
  "request":{
      "amount":100,
      "currency":"USD",
      "description":"Test transaction",
      "tracking_id":"your_uniq_number",
      "billing_address":{
        "first_name":"John",
        "last_name":"Doe",
        "country":"US",
        "city":"Denver",
        "state":"CO",
        "zip":"96002",
        "address":"1st Street"
      },
      "credit_card":{
        "token":"40bd001563085fc35165329ea1ff5c5ecbdbbeef40bd001563085fc35165329e"
      },
      "customer":{
        "ip":"127.0.0.1",
        "email":"john@example.com"
      }
  }
}
Ответ

Параметры ответа копируют параметры запроса за исключением дополнительных:

Параметр Тип Описание
transaction object
uid * обязательный
string UID обработанной транзакции.
status * обязательный
string Статус обработанной транзакции.
message * обязательный
string Сообщение с результатом запроса.
type * обязательный
string Тип транзакции.
tracking_id * обязательный
string Значение параметра tracking_id из запроса.
language * обязательный
string Значение параметра language из запроса или en, если параметр не был передан.
test boolean Транзакция тестовая, если значение true.
payment_method_type * обязательный
string Способ оплаты, используется для завершения транзакции:

credit_card.
credit_card object
brand * required
string Определенный бренд карты.
last_4 * required
string Последние 4 цифры карты.
first_1 * required
string Первая цифра карты.
stamp * required
string Хэш карты. Постоянная величина, даже если дата окончания действия карты или владелец изменены.
token * required
string Токен карты. Позволяет сохранять данные клиентов и производить оплату, когда они делают покупку или вы возобновляете свои услуги.
receipt_url * обязательный
string Ссылка на квитанцию обработанной транзакции.
Пример ответа
{
  "transaction":{
      "customer":{
        "ip":"127.0.0.1",
        "email":"john@example.com"
      },
      "credit_card":{
        "holder":"John Doe",
        "stamp":"3709786942408b77017a3aac8390d46d77d181e34554df527a71919a856d0f28",
        "token":"40bd001563085fc35165329ea1ff5c5ecbdbbeef40bd001563085fc35165329e",
        "brand":"visa",
        "last_4":"0000",
        "first_1":"4",
        "exp_month":5,
        "exp_year":2026
      },
      "receipt_url": "https://gateway.ecomcharge.com/customer/transactions/4107-310b0da80b/11443f39ae75aa1f955a9c9283cd5045bfb0413b65d666f834a9da4e7d3926b5",
      "billing_address":{
        "first_name":"John",
        "last_name":"Doe",
        "address":"1st Street",
        "country":"US",
        "city":"Denver",
        "zip":"96002",
        "state":"CO",
        "phone":null
      },          
      "uid":"4107-310b0da80b",
      "status":"successful",
      "message":"Successfully processed",
      "amount":100,
      "currency":"USD",
      "description":"Test order",
      "type":"payment",
      "tracking_id":"your_uniq_number",
      "language":"en",
      "test": true
  }
}