Tarkibga o'tish

Payme bilan boshlang

1-qadam. Sinov ma'lumotlarini oling

Iltimos, test savdogar, to'lov maxfiy kaliti va karta ma'lumotlarini olish uchun Sinov saytiga tashrif buyuring.

2-qadam. Sinov buyurtmasini yarating

Buyurtma yaratish saytiga tashrif buyuring va oddiy kod parchasidan foydalanib test buyurtma yarating.

Masalan:

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'

3-qadam. Integratsiya turini tanlang

Ko'proq manba kod misollari

$ 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 cloudipsp/php-sdk-v2
Qo'lda o'rnatish
git clone -b master https://github.com/flittpayments/php-sdk.git

Oson boshlash

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

$checkoutData = [
    'currency' => 'UZS',
    'amount' => 1000
];
$data = \Cloudipsp\Checkout::url($checkoutData);
$url = $data->getUrl();
$data->toCheckout();

Oson boshlash 'checkout.js' faylini kiritishni unutmang.

<script src="https://pay.payme.uz/future/checkout-vue/checkout.js"></script>
CSS qo'shing:
<style>body {margin: 0;}</style>
<link rel="preload" href="https://pay.payme.uz/icons/dist/fonts/inter-regular.woff2" as="font" type="font/woff2" crossorigin="anonymous">
<link rel="preload" href="https://pay.payme.uz/icons/dist/fonts/inter-medium.woff2" as="font" type="font/woff2" crossorigin="anonymous">
<link rel="preload" href="https://pay.payme.uz/icons/dist/fonts/inter-semibold.woff2" as="font" type="font/woff2" crossorigin="anonymous">
<link rel="preload" href="https://pay.payme.uz/icons/dist/fonts/cvv.woff" as="font" type="font/woff" crossorigin="anonymous">
<link rel="preload" href="https://pay.payme.uz/icons/dist/fonts/card-number.woff" as="font" type="font/woff" crossorigin="anonymous">
<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: [],
    full_screen: false,
    title: "Example title.",
    active_tab: 'card',
    theme: {
      type: "light",
      preset: "black"
    },
  },
  params: {
    merchant_id: 4056281,
    currency: "UZS",
    order_id: new Date().getTime(),
    amount: 5000,
    order_desc: "Test payment"
  }
};
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. Ko'rsatmalar: 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;
}

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)
})

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": "UZS",
    "amount": 10000
}
url = checkout.url(data).get('checkout_url')