Xazna to‘lov tugmasi

Xaridorni XAZNA to‘lov sahifasiga yo‘naltirish uchun o‘z tomoningizda quyidagi ko‘rinishdagi havola yarating:

https://pay.xazna.uz/billing/universal?merchantId={{$merchantID}}&amount={{$amount}}&invoice={{$invoice}}&returnURL={{$returnURL}}

So‘rov parametrlari

Parametr nomi	Turi	Qiymati
merchantId	UUID	Integratsiya uchun noyob identifikator. XAZNA orqali beriladi.
amount	Integer	To‘lov summasi. So‘mda uzatiladi.
invoice	String	To‘lov uchun noyob parametr.
returnURL	Optional	To‘lovdan keyin foydalanuvchi yo‘naltiriladigan havola.

Misollar

HTML

<a
  class="xazna-pay"
  href="https://pay.xazna.uz/billing/universal?merchantId=string&amount=125000&invoice=321657984213246&returnURL=https%3A%2F%2Fexample.uz%2Forders%2F123"
>
  Xazna orqali to‘lash
</a>

TypeScript

type XaznaPaymentLink = {
  merchantId: string
  amount: number // so‘mda
  invoice: string
  returnURL?: string
}

export function buildXaznaLink(params: XaznaPaymentLink): string {
  const url = new URL('https://pay.xazna.uz/billing/universal')

  url.searchParams.set('merchantId', params.merchantId)
  url.searchParams.set('amount', String(params.amount))
  url.searchParams.set('invoice', params.invoice)

  if (params.returnURL) {
    url.searchParams.set('returnURL', params.returnURL)
  }

  return url.toString()
}

PHP

<?php
$query = http_build_query([
    'merchantId' => $merchantId,
    'amount'     => $amount,   // so'mda
    'invoice'    => $invoice,
    'returnURL'  => $returnURL,
]);

$link = 'https://pay.xazna.uz/billing/universal?' . $query;

returnURL kodlash

returnURL tarkibida : va / belgilari bo‘lgani uchun uni URL-kodlangan holda uzatish kerak. JavaScript'da encodeURIComponent, PHP'da http_build_query buni avtomatik bajaradi.

Keyingi

Havolaga o‘tilgach Xazna sizning billingingizdan info metodi orqali invoys ma'lumotlarini so‘raydi, ularni foydalanuvchiga ko‘rsatadi, mablag‘ni yechadi va pay metodi bilan sizni xabardor qiladi. Tranzaksiya holatini istalgan paytda check metodi orqali aniqlash mumkin.