Tarkibga o'tish

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

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

Barcha gradient nomlari quyidagicha mos keladi (rasmni kattalashtirish uchun bosing):

Presets

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:

valensiya: #D94343
flame_pea: #DF583D
jaffa: #E86F33
rang: #E58626
gamboge: #EBA212
citron: #A9B221
sushi: #82B536
chelsea_cucumber: #6BA854
fruit_salad: #54A868
breaker_bay: #54A199
pelorous: #43ABBF
havelock_blue: #57A4DC
curious_blue: #4F8BE0
indigo: #6073D1
fuchsia_blue: #7054C7
studio: #8453B5
wisteria: #9D55B5
fuchsia_pink: #BA5BB2
mulberry: #C74E8A
kabare: #D4486B