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": {
"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
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>
<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">
<div id="checkout-container"></div>
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>
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')