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