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
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": {
"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
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
Oson boshlash 'checkout.js' faylini kiritishni unutmang.
<script src="https://pay.payme.uz/future/checkout-vue/checkout.js"></script>
<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">
<div id="checkout-container"></div>
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>
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)
})
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')
