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

Принимайте платежи с сохраненной картой

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

Параметры Тип Обязательный Описание
version string(10) необязательный Версия протокола.
Значение по умолчанию: 1.0.1
Версия 1.0 устарела
order_id string(1024) обязательный Идентификатор заказа, сгенерированный мерчантом
merchant_id integer(12) обязательный Уникальный идентификатор мерчанта. Генерируется Paymeво время регистрации мерчанта
order_desc string(1024) обязательный Описание заказа. Генерируется мерчантом в кодировке UTF-8 всегда
amount integer(12) обязательный Сумма заказа без разделителя. 100020 (UZS) означает 1000 сум и 20 тийинов
currency string(3) обязательный Валюта заказа. Поддерживаемые значения:
EUR — евро
USD — доллар США
GBP — фунт стерлингов обязательный
CZK — чешская крона
GEL — грузинский лари
UZS — узбекский сум
Полный список поддерживаемых валют
rectoken string(40) обязательный Токен карты для повторяющихся транзакций.
signature string(40) обязательный Подпись заказа. Требуется для проверки согласованности и подлинности запроса мерчанта. Алгоритм генерации подписи см. на Генерация подписи для запроса и ответа и response
cvv2 string(4) необязательный Код CVV2/CVC2 карты
client_ip string(4) необязательный Client IP
server_callback_url string(2048) необязательный URL сайта продавца, на который будет отправлен обратный вызов host-to-host после завершения платежа. Подробнее об обратных вызовах см. Callbacks .
lifetime integer(9) необязательный Срок действия заказа в секундах. По истечении этого периода статус заказа изменится на «expired», если клиент не оплатил его
Значение по умолчанию: 36000
Максимально допустимое значение: 69120000
merchant_data string(2048) необязательный Любой произвольный набор данных, который мерчант хочет получить в ответе на запросы response_url и/или server_callback_url, а также в отчетах
preauth string(1) необязательный Параметр поддерживается только для способа оплаты Visa/MasterCard
N — сумма списывается с карты клиента немедленно и зачисляется на счет продавца в соответствии с правилами расчетов.
Y — сумма удерживается на счете карты клиента и не списывается до тех пор, пока продавец не отправит запрос capture для подтверждения.
Значение по умолчанию: N
sender_email string(256) необязательный Адрес электронной почты клиента
product_id string(1024) необязательный Идентификатор продукта или услуги продавца

Примеры

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

{
  "request": {
    "order_id": "test_12343242",
    "merchant_id": "4056281",
    "order_desc": "Test order",
    "amount": 1000,
    "currency": "UZS",
    "rectoken": "JcZoqYNosx1HjDoHXWlFU0avVnzYsFAbLBbA",
    "server_callback_url": "https://myserver.com/callback",
    "signature": "0c0c2374c73267e7be560d80834e4ba28ccda7aa"
  }
}

Стандартный окончательный ответ: См. Список тестовых карт

{
  "response": {
    "rrn": "111111111111",
    "masked_card": "444455XXXXXX1111",
    "sender_cell_phone": "",
    "sender_account": "",
    "currency": "UZS",
    "fee": "",
    "reversal_amount": "0",
    "settlement_amount": "0",
    "actual_amount": "1000",
    "response_description": "",
    "sender_email": "test@test.com",
    "order_status": "approved",
    "response_status": "success",
    "order_time": "13.07.2024 01:23:59",
    "actual_currency": "UZS",
    "order_id": "test_12343242",
    "tran_type": "purchase",
    "eci": "5",
    "settlement_date": "",
    "payment_system": "card",
    "approval_code": "123456",
    "merchant_id": 4056281,
    "settlement_currency": "",
    "payment_id": 805243692,
    "card_bin": 444455,
    "response_code": "",
    "card_type": "VISA",
    "amount": "1000",
    "signature": "b7884b5c4906956fbac4d20390388d913a78c0b0",
    "product_id": "",
    "merchant_data": "Test merchant data",
    "rectoken": "",
    "rectoken_lifetime": "",
    "verification_status": "",
    "parent_order_id": "",
    "fee_oplata": "0",
    "additional_info": "{\"capture_status\": null, \"capture_amount\": null, \"reservation_data\": \"{}\", \"transaction_id\": 1994930931, \"bank_response_code\": null, \"bank_response_description\": null, \"client_fee\": 0.0, \"settlement_fee\": 0.0, \"bank_name\": null, \"bank_country\": null, \"card_type\": \"VISA\", \"card_product\": \"empty_visa\", \"card_category\": null, \"timeend\": \"13.07.2024 01:24:08\", \"ipaddress_v4\": \"178.54.60.26\", \"payment_method\": \"card\", \"version_3ds\": 1, \"is_test\": true}",
    "response_signature_string": "**********|200|UZS|{\"capture_status\": null, \"capture_amount\": null, \"reservation_data\": \"{}\", \"transaction_id\": 1994930931, \"bank_response_code\": null, \"bank_response_description\": null, \"client_fee\": 0.0, \"settlement_fee\": 0.0, \"bank_name\": null, \"bank_country\": null, \"card_type\": \"VISA\", \"card_product\": \"empty_visa\", \"card_category\": null, \"timeend\": \"13.07.2024 01:24:08\", \"ipaddress_v4\": \"178.54.60.26\", \"payment_method\": \"card\", \"version_3ds\": 1, \"is_**********\": true}|200|123456|444455|VISA|UZS|5|0|444455XXXXXX1111|Test merchant data|4056281|**********33694502191|approved|13.07.2024 01:23:59|805243692|card|success|0|111111111111|**********@**********.com|0|purchase"
  }
}

Ответ в случае ошибки:

{
    "response": {
        "error_code": 1011,
        "error_message": "Parameter `amount` is missing",
        "request_id": "5htKi0wf7zEHn",
        "response_status": "failure"
    }
}