Ilovada moslashtirilgan to'lov sahifasini yarating. Versiya 2.0¶
O'zingizning veb-saytingizda joylashtirilgan standart HTML va CSS yordamida o'zingizning to'lov sahifangizni yaratishingiz mumkin.
Biz tayyor misol (HTML/CSS/JavaScript) ishlab chiqdik, uni o'zingizning veb-saytingizda sinab ko'rishingiz mumkin:
Kassa dizaynining asosiy namunasi. Karta¶
See the Pen Payme - custom checkout light(@payme-uz) on CodePen.
Avvalo, JavaScript SDK-ni import qilishingiz kerak:
https://pay.payme.uz/future/checkout-vue/checkout.js
Keyin CSS fayllari:
https://pay.payme.uz/future/checkout-vue/checkout.css
To'lov sahifasi JavaScript kodi yordamida sozlanadi:
Konfiguratsiya misoli
var Options = {
options: {
methods: ['card'],
methods_disabled: [],
card_icons: ['humo', 'uzcart'],
active_tab: 'card',
fields: false,
title: 'my_title',
link: 'https://shop.com',
full_screen: true,
button: true,
email: true
},
params: {
merchant_id: 4056281,
required_rectoken: 'y',
currency: 'UZS',
amount: 500,
order_desc: 'my_order_desc',
response_url: 'http://shop.com/thankyoupage'
}
}
checkout("#app", Options);
JavaScript konfiguratsiyasining tuzilishi quyidagicha:
Configuration structure
{
options: {},
params: {},
button: {}, // button config
fields_custom: [],
messages: {},
css_variable: {},
}
To'lov sahifasida forma sozlamalarini sozlang
| Parametr nomi | Parametr turi | O'rnatilgan qiymat | Tavsif |
|---|---|---|---|
methods |
Massiv | ['card'] | card, most_popular, banks, wallets ni qo'llab-quvvatlaydi. |
methods_disabled |
Massiv | [] | card, most_popular, banks, wallets ni qo'llab-quvvatlaydi. |
card_icons |
Massiv | ['humo', 'uzcard'] | mastercard, visa, humo, uzcard |
banks_icons |
Massiv | [] | |
local_methods_icons |
Massiv | [] | |
crypto_icons |
Massiv | [] | |
loans_icons |
Massiv | [] | |
emoney_icons |
Massiv | [] | |
wallets_icons |
Massiv | [] | |
title |
String | ||
link |
String | URL formatini saqlang | |
full_screen |
Boolean | to'g'ri | |
locales |
Massiv | [barchasi] | uz, az, cs, da, de, en, es, fi, fr, hu, it, ka, ko, lv, nl, pl, ro, ru, sk, uk, zh |
api_domain |
String | 'pay.payme.uz' | |
endpoint |
Obyekt | ||
active_tab |
String | 'card' | card, most_popular, banks, wallets |
active_method |
String | '' | |
logo_url |
String | URL formatini saqlang | |
offerta_url |
String | URL formatini saqlang | |
default_country |
String | ||
countries |
Massiv | ||
theme |
Obyekt | ||
show_menu_first |
Boolean | yolgʻon | |
disable_request |
Boolean | yolgʻon | Serverga hech qanday so'rov yuborilmaydi |
subscription |
Obyekt | ||
loading |
String | URL formatini saqlang | |
amount_readonly |
Boolean | to'g'ri | |
autosubmit |
Boolean | yolgʻon | |
show_amount |
Boolean | to'g'ri | |
show_email |
Boolean | yolgʻon | |
show_fee |
Boolean | to'g'ri | |
show_lang |
Boolean | to'g'ri | |
show_link |
Boolean | to'g'ri | |
show_order_desc |
Boolean | to'g'ri | |
show_pay_button_amount |
Boolean | to'g'ri | tugmada summani ko'rsatish |
show_pay_button |
Boolean | to'g'ri | |
show_processed |
Boolean | to'g'ri | |
show_secure_message |
Boolean | to'g'ri | |
show_test_mode |
Boolean | to'g'ri | |
show_title |
Boolean | to'g'ri |
options.theme
| Nomi | Tur | Defolt | Tavsif |
|---|---|---|---|
type |
String | 'light' | support light, dark. |
preset |
'black' | support reset, black, silver, vibrant_silver, vibrant_gold, solid_black, black_and_white, euphoric_pink, heated_steel, nude_pink, tropical_gold, navy_shimmer. |
|
layout |
String | 'default' | quyidagilarni qo'llab-quvvatlaydi: default, plain, wallets_only. |
options.subscription
| Nomi | Tur 1 | Defolt | Tavsif |
|---|---|---|---|
type |
'disable' | support disable, hidden, shown_edit_on, shown_edit_off, shown_readonly |
|
periods |
Array | ['day', 'week', 'month'] | support day, week, month. |
quantity |
Boolean | false | |
trial |
Boolean | false | |
unlimited |
rost | ||
readonly |
Boolean | false |
So'rov parametrlari manzilida tavsiflangan buyurtma parametrlari
| Parametr nomi | Parametr turi | O'rnatilgan qiymat | Tavsif |
|---|---|---|---|
merchant_id |
Butun | 4056281 | |
order_desc |
String | ||
amount |
Butun | null | |
currency |
String | 'UZS' | |
response_url |
String | URL formatini saqlang | |
lang |
String | brauzer tili | |
required_rectoken |
String | Y, N, y, n ni qo'llab-quvvatlaydi. |
|
verification |
String | Y, N, y, n ni qo'llab-quvvatlaydi. |
|
token |
String | Uzoqlik: 40 | |
button |
String | Uzoqligi: 20–80 | |
offer |
Boolean | yolgʻon | |
recurring_data |
Obyekt | ||
custom |
Obyekt | ||
customer_data |
Obyekt |
params.recurring_data
Obuna parametrlari qiymatlari: davomiylik, chastota, boshlanish sanasi, tugash sanasi, takrorlanuvchi miqdor
| Nomi | Turi | Bo'sh | Tavsifi |
|---|---|---|---|
every |
Integer | 1 | |
period |
String | 'month' | quyidagilarni qo'llab-quvvatlaydi: day, week, month. |
amount |
Integer | 0 | |
end_time |
formatidagi satr | YYYY-MM-DD format | |
start_time |
formatidagi satr | YYYY-MM-DD format | |
quantity |
Integer | 0 | |
trial_period |
' | ' satrini | |
trial_quantity |
Integer | 0 |
params.customer_data
| Nomi | Tur | Defolt | Tavsif |
|---|---|---|---|
customer_name |
String | ||
customer_address |
String | ||
customer_zip |
String | ||
customer_city |
String | ||
customer_country |
lug'at mamlakatlari | ||
customer_state |
String | ||
phonemobile |
format phone | ||
email |
format email |
Xabarlarni mahalliylashtirish
{
messages: {
{en}: {
{id}: {value},
...
},
...
},
}
{
css_variable: {
main: {hex color value},
card_bg: {hex color value},
card_shadow: {hex color value}
}
}
{
fields_custom: {
id-1: {
name: 'id-1',
label: 'label1',
value: 'value1',
readonly: true,
p: 1
},
id-2: {
name: 'id-2',
label: 'label2',
value: 'value2',
p: 2
},
id-3: {
name: 'id-3',
label: 'label3',
type: 'checkbox',
required: true,
p: 3
}
}
}
Quyida turli uslublardagi tayyor to'lov sahifasi dizaynlarining misollari keltirilgan.
Oddiy karta to'lov sahifasi dizaynining misoli¶
See the Pen Payme - layout plain(@payme-uz) on CodePen.
JS kod yuborish tugmachasiga ega kartalar uchun oddiy buyurtma formasining dizayn misoli¶
See the Pen Payme - layout plain with submit button(@payme-uz) on CodePen.
Uslub misoli: och rangli fon, ko'k karta¶
See the Pen Payme - custom checkout light(@payme-uz) on CodePen.
Uslub misoli: qorong'i fon, ko'k karta¶
See the Pen Payme - custom checkout dark(@payme-uz) on CodePen.
Qisqa mintaqa uchun misol¶
full_screen: false, hide_title: true, hide_link: true parametrlari bilan
See the Pen Payme - custom checkout. Compact region(@payme-uz) on CodePen.
Savdogar uchun qo'shimcha maydonlar misoli¶
See the Pen Payme - custom checkout. Additional fields. Version 2.0(@payme-uz) on CodePen.
Obuna bo'yicha misol¶
Birinchi muvaffaqiyatli to'lov amalga oshirilgach, to'lov shlyuzasi rejalashtirilgan takroriy to'lovlar taqvimini yaratadi. Takrorlanish chastotasi va vaqti to'lov sahifasi sozlamalarida belgilanadi.
See the Pen Payme - custom checkout. Subscription. Version 2.0(@payme-uz) on CodePen.
Foydalanuvchi maydonlarini obuna va mahalliylashtirish bo'yicha misol¶
See the Pen Payme - custom checkout. Subscription. Version 2.0(@payme-uz) on CodePen.
To'lov tugmasini bosish hodisasini boshqarish misoli¶
See the Pen Payme - checkout with own submit buttons. Version 2.0(@payme-uz) on CodePen.
JavaScript callback misoli¶
Siz response_code parametrining qiymatini ushlab olishingiz va kod xabarini o'zingiznikiga almashtirishingiz mumkin.
Iltimos, kodlar manzilidagi barcha kodlar bilan tanishib chiqing.
See the Pen Payme - custom checkout. Javascript calbacks. Version 2.0 by Maxim (@payme-uz) on CodePen.
Orqa tomonda yaratilgan buyurtma misoli¶
Serveringizda buyurtma yarating:
curl -i -X POST \
-H "Content-Type:application/json" \
-d \
'{
"request": {
"server_callback_url": "http://myshop/callback/",
"order_id": "TestOrder_JSSDK_v2",
"currency": "UZS",
"merchant_id": 4056281,
"order_desc": "Test payment",
"lifetime" : 999999,
"amount": 1000,
"signature": "91ea7da493a8367410fe3d7f877fb5e0ed666490"
}
}' \
'https://pay.payme.uz/api/checkout/token'
Buyurtma tokenini olish:
{
"response":{
"response_status":"success",
"token":"b3c178ad84446ef36eaab365b1e12e6987e9b3d9"
}
}
Buyurtma tokenini parametr sifatida ko'rsatib, to'lov sahifasini yuklang:
var Options = {
options: {
methods: ['card'],
methods_disabled: [],
card_icons: ['humo', 'uzcard'],
active_tab: 'card',
fields: false,
title: 'Demo checkout',
link: 'https://shop.com',
full_screen: true,
button: true,
email: true
},
params: {
token: "13c178ad84446ef36eaab365b1e12e6987e9b3d9"
}
}
checkout("#checkout-container", Options);
Rang sozlamalari va shaxsiy jurnal¶
options bo'limidagi theme obyekti orqali gradient rang sozlamalaridan foydalanishingiz mumkin.
options: {
methods: ['card'],
...
,
theme: {
type: "light",
preset: "black"
}
type atributi 'light' yoki 'dark' qiymatiga ega bo'lishi mumkin.
preset atributi quyidagi qiymatlardan birini qabul qilishi mumkin:
vibrant_gold
vibrant_silver
euphoric_pink
black
solid_black
silver
black_and_white
heated_steel
nude_pink
tropical_gold
navy_shimmer
silver shabloni misoli
See the Pen Payme - minimal checkout ligt euphoric_pink v2.0(@payme-uz) on CodePen.
Barcha gradient nomlari quyidagicha mos keladi (rasmni kattalashtirish uchun bosing):
css_variable parametridan foydalanib o'zingizning tekis ranglaringizni qo'llashingiz mumkin (buni amalga oshirish uchun preset: "reset" ni sozlashingiz kerak), shuningdek, logo_url parametridan foydalanib o'zingizning logotipingizni qo'llashingiz mumkin:
Karta foni uchun valencia #D94343 va tugma rangi uchun fuchsia_blue #7054C7 ishlatilgan shablon misoli
See the Pen Payme - custom colors by Maxim (@payme-uz) on CodePen.
Quyidagi ranglardan foydalanishni tavsiya qilamiz:
