Tarkibga o'tish

JavaScript SDK

JavaScript SDK har qanday HTML sahifasiga xavfsiz tarzda joylashtirilishi mumkin bo'lgan sozlanadigan karta ma'lumotlari formasini taqdim etadi.

 JS SDK

Misol: https://jsfiddle.net/flitt/0sqtb43m/4/

1. O'rnatish

Node Agar loyihangiz Npm-dan foydalansa, quyidagi buyruq yordamida package.json-ga @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":"^1.2"
  }
}

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 callbackida (rectoken parametri).

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: buyurtma yaratish.

Javobdan 'token' parametrini saqlang.

{
    "response": {
        "response_status": "success",
        "token": "7ddb3fbb03d60787b3972ef8d6fad0f97f7d2f86"
    }
}

4. 3-qadamdan olingan 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"
 }

5. To'lovni qayta ishlash natijalarini olish uchun JavaScript callback funksiyalaridan .on('success') va .on('error') foydalaning.

success – order is approved and amount will be charged error – order is declined and amount will not be charged

model.attr('error.message') will contain localized error message in case of payment decline. Order information on order status and details will be returned in model.data.order.order_data

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

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

Yakuniy javob formati: Javob