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

Принять покупку

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

Параметры Тип Обязательный Описание
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 — узбекский сум
Полный список поддерживаемых валют
card_number string(19) необязательный Номер карты плательщика
cvv2 string(4) необязательный Код CVV2/CVC2 карты
expiry_date string(4) необязательный Срок действия карты в формате ММГГ
client_ip string(4) необязательный Client IP
server_callback_url string(2048) необязательный URL сайта продавца, на который будет отправлен обратный вызов host-to-host после завершения платежа. Подробнее об обратных вызовах см. Callbacks .
signature string(40) обязательный Подпись заказа. Требуется для проверки согласованности и подлинности запроса мерчанта. Алгоритм генерации подписи см. на Генерация подписи для запроса и ответа и response
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) необязательный Адрес электронной почты клиента
delayed string(1) необязательный Флаг отложенного заказа .
Y — позволяет клиенту оплатить заказ в течение периода, указанного продавцом в параметре lifetime. Продавец должен ожидать нескольких обратных вызовов между хостами и перенаправлений браузера в рамках одного заказа. У клиента будет возможность повторить попытку оплаты того же order_id, если предыдущая попытка завершилась неудачей
N — после отказа в оплате order_id клиент будет перенаправлен на сайт продавца для повторного создания заказа. В этом случае будет отправлен только один обратный вызов на server_callback_url
Значение по умолчанию: Y
lang string(2) необязательный Язык страницы оплаты. Поддерживаемые значения:
az – азербайджанский
da – датский
nl – голландский
fi – финский
ka – грузинский
ko – корейский
ru – русский
zh – китайский
uk – украинский
en – английский
lv – латышский
fr – французский
cs – чешский
ro – румынский
it – итальянский
sk – словацкий
pl – польский
es – испанский
hu – венгерский
de – немецкий
product_id string(1024) необязательный Идентификатор продукта или услуги продавца
required_rectoken string(1) необязательный Флаг, указывающий, будет ли токен карты возвращен в ответе. См. Recuring payment
Значение по умолчанию: N
verification string(1) необязательный Если отправлено Y, заказ будет автоматически отменен после успешного одобрения
Значение по умолчанию: N
rectoken string(40) необязательный Токен карты для повторяющихся транзакций.
cavv string(2048) необязательный Результат аутентификации 3DSecure карты Значение CAVV
eci string(2048) необязательный Результат аутентификации 3DSecure карты Значение ECI
wallet string(2048) необязательный Тип кошелька: applepay или googlepay
schemeid string(2048) необязательный Идентификатор CIT — транзакции, инициированной клиентом, возвращаемый при первоначальной покупке в поле additional_info->schemeid, см. параметры ответа response parameters

Примеры

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

{
  "request": {
    "order_id": "test_12343242",
    "merchant_id": "4056281",
    "order_desc": "Test order",
    "amount": 1000,
    "currency": "UZS",
    "card_number": "4444555566661111",
    "cvv2": "111",
    "expiry_date": "1125",
    "client_ip": "8.8.8.8",
    "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": "200",
    "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": "test33694502191",
    "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": "200",
    "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"
  }
}

Стандартный ответ, если требуется 3DSecure: См. Список тестовых карт 3DSecure

{
    "response": {
        "response_status": "success",
        "acs_url": "https://pay.payme.uz/test/testacs/",
        "pareq": "eJxtU21vgjAQ/u6vIP4A+gJRNKVJHUvUiRpwS/aRYYNsgljA6b8fLTpFuISE5+5pe/fcHdnsBOeOz8NScNrTKiMuz/Mg4lq8tfuDyqxRv46o6Jp5/HjHynfiIo8PKUU61DEBN9gkuVyEuyAtmm4VCsLjZLakpjUyDUTAFbZ5CRczhxpDDCsjoIZtWhoknC7Y5mM2Z762Zv6GaRO2fGMEqFD7RHgo00JcqIktAm6gTSvFnu6KIsvHQD6uysn1ffal708EyGizZNBdM1mX0p13ZXKOt9R12O/Th5ffn3jl/NgESEb73DYoOMUQmdDCloaGY4jGaECA8nconsgiKdYh1F7fvUrz2tFmZjJXdqVL1R8dHUqWQvA0vNDRUEp5Q20iP2eHlMtLCfj/f5KvWyfyMu2cobCopsFNVsZ8yhdHL1rNkedH0Ev8yLblVClCZyZx1W4DozqV+Ln3BDy+WKV1XwHZYrUttEdAY5f+AHcC0ak=",
        "md": "2001876637"
    }
}

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

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