Создание ссылки для оплаты
| Имя | Тип | Описание | Требуется |
|---|---|---|---|
| merchant_id | UUID4 | Merchant ID | Да |
| account | Account | Учетная запись пользователя службы | Да |
| amount | Amount | Сумма платежа | Да |
| amount_in_tiyin | Логическое значение (Истина/Ложь) | Определяет, указано ли поле суммы в тийине (пенни) или нет. | Нет (если не включено, по умолчанию установлено значение False) |
| currency_id | int | 860 - UZS \ | 840 - USD |
| convert_to | int | 860 - UZS \ | 840 - USD |
Если сумма указана в тийынах (пенни), ее следует умножить на 100 (например, 100 UZS → 10000 тиын) и в конце должно быть не более двух цифр. Если это не тийин, используйте стандартную сумму (например, 100 UZS → 100).
Поле: convert_to
Если указано, транзакция будет сгенерирована в указанной валюте (SUM или USD). Сумма платежа будет конвертирована по текущему обменному курсу Центрального банка Узбекистана на момент создания транзакции.
Создание примера URL
- Создать запрос: merchant_id=571c06fb-6c61-4ef7-8567-5511abaf12b5&amount=500&account.order_id=12&return_url=https://returnurl
- Закодировать запрос в формат bas64: bWVyY2hhbnRfaWQ9NTcxYzA2ZmItNmM2MS00ZWY3LTg1NjctNTUxMWFiYWYxMmI1JmFtb3VudD01MDAmYWNjb3VudC5vcmRlcl9pZD0xMg==
- Объедините закодированный запрос с базовым URL (https://my.paylov.uz/checkout/create/{query}) https://my.paylov.uz/checkout/create/bWVyY2hhbnRfaWQ9NTcxYzA2ZmItNmM2MS00ZWY3LTg1NjctNTUxMWFiYWYxMmI1JmFtb3VudD01MDAmYWNjb3VudC5vcmRlcl9pZD0xMg==
Параметры запроса для платежей UZS
json
query_params = {
"merchant_id": merchant_id,
"amount": amount,
"return_url": return_url
}Параметры запроса для платежей Visa/Master USD
json
query_params = {
"merchant_id": merchant_id,
"amount": amount,
"return_url": return_url,
"amount_in_tiyin": True,
"currency_id": 840
}пример кода Python для генерации платежа
python
import base64
import urllib.parse
def generate_payment_link(base_url, merchant_id, amount, account_params, return_url):
# Create query string
query_params = {
"merchant_id": merchant_id,
"amount": amount,
"return_url": return_url
}
# Add account-related fields
for key, value in account_params.items():
query_params[f"account.{key}"] = value
query_string = urllib.parse.urlencode(query_params)
# Encode query string to Base64
encoded_query = base64.b64encode(query_string.encode()).decode()
# Combine with base URL
payment_link = f"{base_url}{encoded_query}"
return payment_link
# Example usage
base_url = "https://my.paylov.uz/checkout/create/"
merchant_id = "0das467e-82sf-42df-8642-g51aawy5ga2r"
amount = "500"
account_params = {"order_id": "1233"}
return_url = "https://returnurl"
payment_link = generate_payment_link(base_url, merchant_id, amount, account_params, return_url)
print(payment_link)