EPoint¶

Rəsmi Dokumentasiya (v1.0.3)¶

Azərbaycanca

İngliscə

Rusca

Sorğular listi¶

Sorğu metodu	Məqsəd	EPoint API	Callback-ə sorğu atılır
pay	Ödəniş	/api/1/request
get_transaction_status	Ödəniş statusunun yoxlanılması	/api/1/get-status
save_card	Ödəniş olmadan kartı yadda saxlamaq	/api/1/card-registration
pay_with_saved_card	Saxlanılan kartla ödəniş	/api/1/execute-pay
pay_and_save_card	Ödəniş etmə və kartı yadda saxlamaq	/api/1/card-registration-with-pay
payout	Vəsaitlərin köçürülməsi	/api/1/refund-request
refund	Ödənişi tam və ya yarımçıq geri qaytarma	/api/1/reverse
split_pay	Ödənişi başqa EPoint istifadəçisi ilə bölüb ödəmə	/api/1/split-request
split_pay_with_saved_card	Saxlanılmış kartla ödənişi başqa EPoint istifadəçisi ilə bölüb ödəmə	/api/1/split-execute-pay
split_pay_and_save_card	Ödənişi başqa EPoint istifadəçisi ilə bölüb ödəmə və kartı saxlamaq	/api/1/split-card-registration-with-pay

Callback Sorğusu¶

Bəzi sorğular müştəri məlumat daxil etdikdən və arxa fonda bank işləmləri bitdikdən sonra, tranzaksiya haqqında məlumat sizin EPoint dashboard-da qeyd etdiyiniz callback URL-ə POST sorğusu göndərilir. Data siz adətən sorğu göndərdiyiniz formatda gəlir:

{
    'data': 'base64data'
    'signature': 'sha1signature'
}

Bu data-nı signature-ni yoxladıqdan sonra, decode etmək lazımdır. Callback üçün API yazdıqda, datanı alıb, helpers.py-dakı decode_callback_data funksiyası ilə həm signature yoxlanması həm də datanın decode-unu edə bilərsiniz. Bu funksiya sizə DecodedCallbackDataSchema formatında decode olunmuş datanı qaytarır.

Qeyd

FastAPI istifadəçiləri kiçik "shortcut"-dan istifadə edə bilərlər:

from fastapi import Fastapi, APIRouter, Depends
from integrify.epoint.schemas.callback import DecodedCallbackDataSchema
from integrify.epoint.helpers import decode_callback_data

router = APIRouter()

@router.post('/epoint/callback')
async def epoint_callback(data: DecodedCallbackDataSchema = Depends(decode_callback_data)):
   ...

Funksiyanı belə yazdıqda, data avtomatik signature-i yoxlanaraq decode edilir.

Callback Data formatı¶

Nə sorğu göndərməyinizdən asılı olaraq, callback-ə gələn data biraz fərqlənə bilər. DecodedCallbackDataSchema bütün bu dataları özündə cəmləsə də, hansı fieldlərin gəlməyəcəyini (yəni, decode-dan sonra None olacağını) bilmək yaxşı olar. Ümumilikdə, mümkün olacaq datalar bunlardır:

Sorğudan asılı olaraq, bu data-lar callback-də GƏLMİR (yəni, avtomatik None dəyəri alır):

Qeyd

Qalan bütün data-lar sorğu success olduqda gəlir, əks halda, onlar da None dəyəri alır.