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

Проверка

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

Запрос

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

Note

Тело запроса должно быть обёрнуто в корневой объект request{}.
amount
обязательный
 integer
Стоимость в минимальных денежных единицах. Например, $32.45 должна быть отправлена как 3245.
currency
обязательный
 string
Валюта в ISO-4217 формате, например USD.
description
обязательный
 string (255)
Описание заказа.
tracking_id
обязательный
 string (255)
ID транзакции или заказа в вашей системе. Пожалуйста, используйте уникальное значение для того, чтобы при запросе статуса транзакции получить актуальную информацию. В противном случае вы получите массив данных по 10 последним транзакциям, найденным по указанному 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 уведомление о транзакции включено, PayCross отправит email, локалью которого будет language. По умолчанию - en. Доступные значения параметра language.
notification_url
 string
URL, на который будут приходить уведомления. Формат запроса уведомления аналогичен формату ответа транзакции.
verification_url
 string
URL, на который будут приходить запрос на подтверждение транзакции. Формат запроса на подтверждение аналогичен формату ответа транзакции.
test
 boolean
Транзакция тестовая, если значение true.
object
number
условно обязательный
 string (19)
Номер карты.
holder
условно обязательный
 string (32)
Имя владельца карты.
exp_month
обязательный
 integer
Месяц окончания срока действия карты, представленный двумя цифрами (например, 01).
exp_year
обязательный
 integer
Год срока окончания действия карты, представленный четырьмя цифрами (например, 2027).
verification_value
условно обязательный
 string
3-х или 4-х цифровой код безопасности (CVC2, CVV2 или CID, в зависимости от бренда карты).
token
условно обязательный
 string
Вместо 5 параметров выше вы можете отправить токен карты, который вы получили в ответе первой оплаты.
условно обязательный
 object
Секция информации о покупателе.
Уточните у Службы технической поддержки, необходимо ли передавать параметры данной секции.
ip
 string
IP-адрес покупателя, производящего оплату в вашем магазине.
email
 string
email покупателя, производящего оплату в вашем магазине.
external_id
 string (255)
Идентификатор покупателя в системе торговца.
object
first_name
условно обязательный
 string (30)
Имя покупателя.
last_name
условно обязательный
 string (30)
Фамилия покупателя.
country
условно обязательный
 string
Страна покупателя в ISO 3166-1 alpha-2 формате.
city
условно обязательный
 string (60)
Город покупателя. Максимальная длина: 60 символов.
state
условно обязательный
 string
Двухбуквенная абревиатура штата, если страна покупателя IN, 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":"2027"
      },
      "customer":{
        "ip":"127.0.0.1",
        "email":"[email protected]"
      }
  }
}
Пример запроса с токеном карты 
{
  "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":"[email protected]"
      }
  }
}
Ответ

Параметры ответа копируют параметры запроса за исключением дополнительных:
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.
object
brand
обязательный
 string
Определенный бренд карты.
last_4
обязательный
 string
Последние 4 цифры карты.
first_1
обязательный
 string
Первая цифра карты.
stamp
обязательный
 string
Хэш карты. Постоянная величина, даже если дата окончания действия карты или владелец изменены.
token
обязательный
 string
Токен карты. Позволяет сохранять данные покупателей и производить оплату, когда они делают покупку или вы возобновляете свои услуги.
receipt_url
обязательный
 string
Ссылка на квитанцию обработанной транзакции.
Пример ответа 
{
  "transaction":{
      "customer":{
        "ip":"127.0.0.1",
        "email":"[email protected]"
      },
      "credit_card":{
        "holder":"John Doe",
        "stamp":"3709786942408b77017a3aac8390d46d77d181e34554df527a71919a856d0f28",
        "token":"40bd001563085fc35165329ea1ff5c5ecbdbbeef40bd001563085fc35165329e",
        "brand":"visa",
        "last_4":"0000",
        "first_1":"4",
        "exp_month":5,
        "exp_year":2027
      },
      "receipt_url": "https://admin.pay-cross.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",
      "payment_method_type": "credit_card",
      "tracking_id":"your_uniq_number",
      "language":"en",
      "test": true
  }
}