Tarkibga o'tish

Buyurtma yarating

Buyurtma yarating — aynan shu yerda ko'pgina integratsiyalar boshlanadi.

Buyurtma yaratish uchun endpunktlar

Payme to'lov sahifasi to'lov URL manzili bilan

Payme hosted checkout page with checkout url

POST /api/checkout/url

Ushbu API manzili POST so'rovini JSON formatida va so'rov parametrlari bilan kutadi.

Oddiy javob checkout_url parametrini o'z ichiga oladi — bu to'lovchini qayerga yo'naltirish kerak bo'lgan checkout sahifasining URL manzili.

So'rov/javob misollari

curl -i -X POST \
-H "Content-Type:application/json" \
-d \
'{
"request": {
"server_callback_url": "http://myshop/callback/",
"order_id": "TestOrder2",
"currency": "UZS",
"merchant_id": 4056281,
"order_desc": "Test payment",
"amount": 1000,
"signature": "91ea7da493a8367410fe3d7f877fb5e0ed666490"
}
}' \
'https://pay.payme.uz/api/checkout/url'
{
    "response":{
        "response_status":"success",
        "checkout_url":"https://pay.payme.uz/merchants/5ad6b888f4becb0c33d543d54e57d86c/default/index.html?token=8a09f9d937f43ad6fb40d6b40282d7277a48582a"
    }
}
{
    "response":{
        "response_status":"failure",
        "error_message":"Parameter `amount` is mandatory",
        "error_code":"1008"
    }
}

To'lov tokeni bilan integratsiyalashgan sotuvchi kassasi sahifasi

Ushbu API nuqtasi quyidagilarni qayta ishlaydigan mobil ilovalar uchun eng yaxshi ishlatiladi:

Merchant embedded checkout page with payment token

POST /api/checkout/token

Ushbu API manzili POST so'rovini JSON formatida va so'rov parametrlari bilan kutadi.

Farqi shundaki, standart javob token parametrini o'z ichiga oladi — bu keyinchalik JavaScript va mobil SDKlarda ishlatilishi mumkin bo'lgan to'lov tokenidir.

So'rov/javob misollari

curl -i -X POST \
-H "Content-Type:application/json" \
-d \
'{
"request": {
"server_callback_url": "http://myshop/callback/",
"order_id": "TestOrder2",
"currency": "UZS",
"merchant_id": 4056281,
"order_desc": "Test payment",
"amount": 1000,
"signature": "91ea7da493a8367410fe3d7f877fb5e0ed666490"
}
}' \
'https://pay.payme.uz/api/checkout/token'
{
    "response": {
        "token": "9f0124be2b72333fb0e809f82c8f7e4eaeb6ec6e",
        "response_status": "success"
    }
}
{
    "response":{
        "response_status":"failure",
        "error_message":"Parameter `amount` is mandatory",
        "error_code":"1008"
    }
}

Payme to'lov sahifasi yo'naltirish bilan

Payme hosted checkout page with redirect

POST /api/checkout/redirect

Ushbu API manzili POST so'rovini JSON formatida va so'rov parametrlari bilan kutadi.

Oddiy javob HTTP holat kodini 302 Found va URL manzilini Location o'z ichiga oladi, to'lovchi brauzeri ularni avtomatik ravishda shu manzilga yo'naltiradi.

Agar xato yuz bersa, /api/checkout/redirect sahifasida so'rov IDsi, 4 raqamli 2XXX xato kodi va mahalliylashtirilgan xato tavsifi bilan HTML kontenti bo'ladi.

So'rov/javob misollari

<form method="POST" action="https://pay.payme.uz/api/checkout/redirect">
    <input type="text" class="form-input" id="order_id" name="order_id" value="test8651190566">
    <input type="text" class="form-input" id="merchant_id" name="merchant_id" value="4056281">
    <input type="text" class="form-input" id="order_desc" name="order_desc" value="Test order">
    <input type="text" class="form-input" id="amount" name="amount" value="200">
    <input type="text" class="form-input" id="currency" name="currency" value="UZS">
    <input type="text" class="form-input" id="response_url" name="response_url" value="https://site.com/test/responsepage/">
    <input type="text" class="form-input" id="signature" name="signature" value="31c758a76a5dae87f087df171092684130a12bf3">
    <button type="submit">Pay</button>
</form>
Request URL: https://pay.payme.uz/api/checkout/redirect/
Request Method: POST
Status Code: 302 Found
Location: https://pay.payme.uz/merchants/5ad6b888f4becb0c33d543d54e57d86c/default/index.html?token=8a09f9d937f43ad6fb40d6b40282d7277a48582a

Sahifani yo'naltirish

Manba kod namunasi

$ curl -L 'https://pay.payme.uz/api/checkout/url' \
-H 'Content-Type: application/json' \
-d '{
  "request": {
    "version": "1.0.1",
    "order_id": "test_order_id_132412412",
    "currency": "UZS",
    "merchant_id": 4056281,
    "order_desc": "Test order",
    "amount": 10025,
    "response_url": "https://example.com/thankyoupage",
    "server_callback_url": "https://example.com/api/callback",
    "signature": "7f52380cefaf3cb793746e2deeb56cf7cd75d532"
  }
}'
response:
{
  "response": {
    "checkout_url": "https://pay.payme.uz/merchants/5ad6b888f4becb0c33d543d54e57d86c/default/index.html?token=03fb1c589f8fcabc80f609c70af541fc636df112",
    "payment_id": "805230052",
    "response_status": "success"
  }
}

Composer-ni o'rnatish

composer require flittpayments/php-sdk
Qo'lda o'rnatish
git clone -b master https://github.com/flittpayments/php-sdk.git

Oson boshlash

require 'vendor/autoload.php';
\Flitt\Configuration::setMerchantId(4056281);
\Flitt\Configuration::setSecretKey('test');

$checkoutData = [
    'currency' => 'UZS',
    'amount' => 1000
];
$data = \Flitt\Checkout::url($data);
$url = $data->getUrl();
//$data->toCheckout() - redirect to checkout

Misol

cd ~/php-sdk
php -S localhost:8000

Buyurtma yaratish misoli:

Oson boshlash 'checkout.js' faylini kiritishni unutmang.

<script src="https://pay.payme.uz/future/checkout-vue/checkout.js"></script>
CSS qo'shing:
<link rel="preload" href="https://pay.payme.uz/future/checkout-vue/checkout.css" as="style">
<link href="https://pay.payme.uz/future/checkout-vue/checkout.css" rel="stylesheet">
HTML konteyneri:
<div id="checkout-container"></div>
JavaScript kodi:

var Options = {
  options: {
    methods: ["card"],
    methods_disabled: [],
    card_icons: ["mastercard", "visa"],
    theme: {
      type: "light",
      preset: "reset"
    }
  },
  params: {
    merchant_id: 4056281,
    currency: "UZS",
    amount: 500,
    order_desc: "Demo order"
  },
  css_variable: {
    main: '#7d8ff8',
    card_bg: '#353535',
    card_shadow: '#9ADBE8'
  }
};
checkout("#checkout-container", Options);

1. O'rnatish

Node Agar loyihangiz Npm'dan foydalansa, quyidagi buyruq yordamida package.json fayliga @flittpayments/js-sdk bog'liqligini qo'shishingiz mumkin:

npm i --save @flittpayments/js-sdk

yoki bog'liqlikni qo'lda qo'shing:

{
  "dependency": {
    "@flittpayments/js-sdk":"^2.0"
  }
}

Qo'lda o'rnatish Agar siz NodeJS'dan foydalanmayotgan bo'lsangiz, eng so'nggi versiyasini yuklab olishingiz mumkin. Yoki GitHub'dan eng so'nggi ishlab chiquvchi versiyasini klonlashingiz mumkin.

git clone git@github.com:flittpayments/js-sdk.git

Tez boshlash

<script src="https://cdn.jsdelivr.net/npm/@flittpayments/js-sdk"></script>
2. O'zingizning dizayningizdan foydalangan holda HTML formatida karta ma'lumotlarini kiritish formasini ishlab chiqing.

Asosiy shablon

<!DOCTYPE html>
<html lang="en">
  <head>
    <meta charset="utf-8">
    <meta name="viewport" content="width=device-width, initial-scale=1, shrink-to-fit=no">
  </head>
  <body>
    <script src="https://cdn.jsdelivr.net/npm/@flittpayments/js-sdk"></script>
    <script>
    $checkout('Api').scope(function(){
        this.request('api.checkout.form','request', { Parameters } ).done(function(model){
            model.sendResponse();
            console.log(model.attr('order'));
        }).fail(function(model){
            console.log(model.attr('error'));
        });
    });
    </script>
  </body>
</html>

Asosiy shablon misoli: https://github.com/flittpayments/js-sdk#basic-template

3. JavaScript SDK uchun integratsiya sxemasi C yordamida buyurtma yarating.

Takroriy to'lov tokenini olish uchun (agar siz takroriy to'lovlarni qayta ishlashni rejalashtirayotgan bo'lsangiz) so'rovingizga required_rectoken=Y va server_callback_url parametrlarini qo'shing. server callback (rectoken parametri)da.

curl -i -X POST \
-H "Content-Type:application/json" \
-d \
'{
"request": {
"server_callback_url": "http://myshop/callback/",
"order_id": "TestOrder2",
"currency": "UZS",
"merchant_id": 4056281,
"order_desc": "Test payment",
"amount": 1000,
"signature": "91ea7da493a8367410fe3d7f877fb5e0ed666490"
}
}' \
'https://pay.payme.uz/api/checkout/token'

Hujjat: https://docs.payme.uz/docs/page/3/?la=en#chapter-3-6-c. Javobdan host-dan-hostga token parametrini saqlang.

4. 3-qadamdagi host-to-host tokenni karta ma'lumotlari formasiga yuklang.

{
 "payment_system":"card",
 "token":"host-to-host generated token",
 "card_number":"16/19-digits number",
 "expiry_date":"Supported formats: MM/YY, MM/YYYY, MMYY, MMYYYY",
 "cvv2":"3-digits number"
 }

kartalar formasidan to'lov darvozasiga JavaScript API $checkout('Api') yordamida. https://github.com/flittpayments/js-sdk#host-to-host-token

5. To'lovni qayta ishlash natijasini olish uchun JavaScript callbacklari .on('success') va .on('error') dan foydalaning.

muvaffaqiyat – buyurtma tasdiqlandi, summa hisobdan yechib olinadi xato – buyurtma rad etildi, summa hisobdan yechilmaydi

model.attr('error.message') to'lov rad etilganda mahalliylashtirilgan xato xabarini o'z ichiga oladi. Buyurtma holati va tafsilotlari haqidagi ma'lumot model.data.order.order_data orqali qaytariladi.

JavaScriptdagi callback misoli:

console.log('success',JSON.stringify(model.attr("order").order_data));
{
  "response": {
    "rrn": "111111111111",
    "masked_card": "444455XXXXXX1111",
    "sender_cell_phone": "",
    "sender_account": "",
    "currency": "UZS",
    "fee": "",
    "reversal_amount": "0",
    "settlement_amount": "0",
    "actual_amount": "200",
    "response_description": "",
    "sender_email": "test@test.com",
    "order_status": "approved",
    "response_status": "success",
    "order_time": "13.07.2024 01:23:59",
    "actual_currency": "UZS",
    "order_id": "test33694502191",
    "tran_type": "purchase",
    "eci": "5",
    "settlement_date": "",
    "payment_system": "card",
    "approval_code": "123456",
    "merchant_id": 4056281,
    "settlement_currency": "",
    "payment_id": 805243692,
    "card_bin": 444455,
    "response_code": "",
    "card_type": "VISA",
    "amount": "200",
    "signature": "b7884b5c4906956fbac4d20390388d913a78c0b0",
    "product_id": "",
    "merchant_data": "Test merchant data",
    "rectoken": "",
    "rectoken_lifetime": "",
    "verification_status": "",
    "parent_order_id": "",
    "fee_oplata": "0",
    "additional_info": "{\"capture_status\": null, \"capture_amount\": null, \"reservation_data\": \"{}\", \"transaction_id\": 1994930931, \"bank_response_code\": null, \"bank_response_description\": null, \"client_fee\": 0.0, \"settlement_fee\": 0.0, \"bank_name\": null, \"bank_country\": null, \"card_type\": \"VISA\", \"card_product\": \"empty_visa\", \"card_category\": null, \"timeend\": \"13.07.2024 01:24:08\", \"ipaddress_v4\": \"178.54.60.26\", \"payment_method\": \"card\", \"version_3ds\": 1, \"is_test\": true}",
    "response_signature_string": "**********|200|UZS|{\"capture_status\": null, \"capture_amount\": null, \"reservation_data\": \"{}\", \"transaction_id\": 1994930931, \"bank_response_code\": null, \"bank_response_description\": null, \"client_fee\": 0.0, \"settlement_fee\": 0.0, \"bank_name\": null, \"bank_country\": null, \"card_type\": \"VISA\", \"card_product\": \"empty_visa\", \"card_category\": null, \"timeend\": \"13.07.2024 01:24:08\", \"ipaddress_v4\": \"178.54.60.26\", \"payment_method\": \"card\", \"version_3ds\": 1, \"is_**********\": true}|200|123456|444455|VISA|UZS|5|0|444455XXXXXX1111|Test merchant data|4056281|**********33694502191|approved|13.07.2024 01:23:59|805243692|card|success|0|111111111111|**********@**********.com|0|purchase"
  }
}

Misol: https://jsfiddle.net/flitt/on8ydsgq/1/

6. Server callbacklari orqali olingan yakuniy javobni server_callback_url faylida qayta ishlang.

Yakuniy javob formati: Javob

O'rnatish SDK quyidagi manzilda mavjud: NuGet

Oson boshlash

using FlittSDK;
using FlittSDK.Checkout;

Config.MerchantId = 4056281;
Config.SecretKey = "test";

var req = new CheckoutRequest {
  order_id = Guid.NewGuid().ToString("N"),
  amount = 100000,
  order_desc = "checkout json demo",
  currency = "UZS"
};
var resp = new Url().Post(req);
if (resp.Error == null) {
 string url = resp.checkout_url;
}

Misolni sinab ko'rish uchun: o'rnatilgan ISS serveridan foydalanishingiz mumkin http://localhost:7777/

O'rnatish

npm install @flittpayments/flitt-node-js-sdk

Qo'lda o'rnatish

git clone -b master https://github.com/flittpayments/node-js-sdk.git

Oson boshlash

const FlittPay = require('@flittpayments/flitt-node-js-sdk')

const flitt = new FlittPay(
  {
    merchantId: 4056281,
    secretKey: 'test'
  }
)
const requestData = {
  order_id: 'Your Order Id',
  order_desc: 'test order',
  currency: 'UZS',
  amount: '1000'
}
flitt.Checkout(requestData).then(data => {
  console.log(data)
}).catch((error) => {
  console.log(error)
})

Buyurtma yaratish misoli:

O'rnatish

pip install flittpayments

Oson boshlash

from flittpayments import Api, Checkout
api = Api(merchant_id=4056281,
          secret_key='test')
checkout = Checkout(api=api)
data = {
    "currency": "USD",
    "amount": 10000
}
url = checkout.url(data).get('checkout_url')