Принять покупку¶
Параметры запроса
| Параметры | Тип | Обязательный | Описание |
|---|---|---|---|
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"
}
}