Callback (success)

После успешного списания средств с карты плательщика отправляется callback-запрос от платежного шлюза Multicard на URL партнера, отправленным в запросе на создание инвойса.

Запрос отправляется со следующего IP: 195.158.26.90. При получении запроса система мерчанта должна проверить поле sign, либо установить ограничение на прием запросов только с этого IP-адреса.

sign формируется как md5-хеш от строки (без скобок):
{store_id}{invoice_id}{amount}{secret}

Для успешного ответа на указанный запрос необходимо ответить HTTP STATUS=200.

Платеж отменяется (средства будут возвращены плательщику) в случае получения HTTP-статуса, отличного от 200 и/или если в теле ответа success != true. Значение из поля message будет отображено пользователю на странице неуспешной оплаты (чек).

Пример неуспешного ответа (поле message будет отображено плательщику на странице оплаты):
{
"success": false,
"message": "Не найден инвойс"
}

При таймауте или получении HTTP-статуса 500, система Multicard заморозить транзакцию (средства будут заблокированы на карте плательщика). В таком случае, коллбэк-запрос может быть отправлен повторно. В связи с этим, при получении повторного запроса по инвойсу с тем же uuid (уникальный ID транзакции Multicard), если платеж успешный, необходимо вернуть успешный статус и обеспечить идемпотентность транзакции.

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

curl --location --request POST '/' \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --data-raw '{ "store_id": 6, "amount": 20000, "invoice_id": "2024864028760", "billing_id": "20241214242009869794410864028760", "payment_time": "2024-12-14 14:36:31", "phone": "998930601725", "card_pan": "860030******5959", "ps": "uzcard", "card_token": "6225f3c93f7a880142782fa4", "uuid": "e60d8ebc-b9fe-11ef-b159-005056b4367d", "receipt_url": "https://dev-checkout.multicard.uz/check/e60d8ebc-b9fe-11ef-b159-005056b4367d", "sign": "553b4292b0f1d8e0e18e6daeb3af3761" }'

Request

Responses