Stripe qoşulması

Stripe vasitəsilə onlayn ödənişlərin qəbulu: kartlar, Apple Pay, Google Pay.

1. Ümumi baxış#

Stripe — qlobal ödəniş platformasıdır. Cenaly reyestrində Stripe 46 ölkədə qoşulmaq üçün əlçatandır. Cenaly + Stripe inteqrasiyası imkan verir:

• 💳 Ödəniş qəbul etmək kartlarla (Visa, Mastercard, AmEx)
• 📱 Apple Pay / Google Pay — bir toxunuşla ödəniş
• 💰 Ödənişləri almaq bank hesabınıza
• 🔄 Geri qaytarmaları emal etmək admin paneldən
• 💵 Çaypulu — qonaq ödəniş zamanı çaypulu əlavə edir
• 📊 Hesabatlar — tam maliyyə analitikası

2. Tələblər#

• ✅ Cenaly hesabı (onlayn ödəniş istənilən planda, o cümlədən pulsuz planda əlçatandır)
• ✅ Stripe hesabı (stripe.com saytında pulsuz qeydiyyat)
• ✅ Ödənişlərin alınması üçün bank hesabı (ölkənizin valyutasında)
• ✅ Doğrulama üçün sənədlər (pasport / ID, şirkət sənədləri)

Dəstəklənən ölkələr#

Stripe 46 ölkədə qoşulmaq üçün təklif olunur:

3. Stripe hesabının yaradılması#

Addım 1. Qeydiyyat#

1. stripe.com saytına keçin → Start now
2. E-poçt ünvanınızı qeyd edin və parol yaradın
3. E-poçtu təsdiqləyin

Addım 2. Biznesin doğrulanması#

Stripe tələb edəcək:

Doğrulama adətən 1–3 iş günü çəkir.

Addım 3. API açarlarını əldə edin#

1. Stripe idarə panelində: Developers → API keys
2. Kopyalayın:
   • Publishable key (pk_live_...)
   • Secret key (sk_live_...)

4. Cenaly-yə qoşulma#

Sizin öz Stripe hesabınız qoşulur: qonağın pulu birbaşa sizin Stripe balansınıza gedir, Cenaly onları saxlamır.

Tətbiq mağazası → «Maliyyə» kateqoriyası → Stripe kartı → «Konfiqurasiya et» bölməsini açın — qoşulma bloku birbaşa mağazada modal pəncərə kimi açılacaq. Adi yol da işləyir: Filiallar → filial kartı → «Ödənişlər» sekmesi («Qonaq ödənişi» bölməsi), Stripe kartının yanındaki «Qoş» düyməsi.

Qoşulma ustası (tövsiyə olunur)#

Addım-addım usta (≈10 dəqiqə) bütün prosesi keçirir və Stripe idarə panelində hara basmağı göstərir:

1. Rejimi seçin — test və ya canlı. Stripe-dəki rejim və Cenaly-dəki «Test / Canlı» açarı üst-üstə düşməlidir.
2. Açarları kopyalayın — Developers → API keys: Secret key (sk_test_… / sk_live_…) mütləqdir, Publishable key (pk_…) — istəyə bağlı.
3. Vebhuku əlavə edin — Developers → Webhooks → Add endpoint, Endpoint URL sahəsinə isə ustanın «Kopyala» düyməsi ilə verdiyi Cenaly vebhuk ünvanını yerləşdirin. Vebhuk olmadan Stripe sifarişin ödənildiyini bildirməyəcək və sifariş «gözləyir» statusunda qala bilər.
4. Hadisələri seçin — «Select events» blokunda mütləq checkout.session.completed əlavə edin (məhz bu, sifarişin ödənişini təsdiqləyir), gecikdirilmiş ödəniş üsulları üçün isə əlavə olaraq checkout.session.async_payment_succeeded və checkout.session.async_payment_failed. Sonra «Add endpoint» düyməsini basın. Bu hadisələr olmadan vebhuk yaradılır, lakin ödəniş barədə məlumat verməyəcək.
5. Webhook signing secret (whsec_…) kopyalayın — məcburi olmayan sahədir, lakin onunla bildirişlərin imzasının yoxlanması işə düşür.
6. Qoş — daxil edilmiş dəyərlər qorunan backend-ə göndərilir.

Qısa forma#

Əgər Stripe-də nəyin harada olduğunu artıq bilirsinizsə, qoşulmanın inline formasını açın və eyni sahələri doldurun: Secret key, Webhook signing secret (istəyə bağlı), Publishable key (istəyə bağlı) və rejim açarı.

5. Ödəniş üsullarının konfiqurasiyası#

Bank kartları#

Stripe qoşulduqda avtomatik aktivləşdirilir:

• Visa / Mastercard — bütün ölkələr
• American Express — ölkələrin əksəriyyəti
• Diners Club / Discover — seçmə qaydada

Apple Pay və Google Pay#

Cenaly-də onlar üçün ayrıca açarlar yoxdur: ödəniş Stripe Checkout hosted səhifəsində həyata keçirilir, buna görə də pul kisələri Stripe tərəfində aktivləşdirilir.

• Google Pay — Stripe qoşulduqdan dərhal sonra işləyir (Android, Chrome).
• Apple Pay — Stripe domeni təsdiqləməyi tələb edir: Settings → Payment methods → Apple Pay → Add new domain. Doğrulamadan sonra düymə iOS/Safari-də görünəcək.

Digər üsullar#

Stripe Dashboard vasitəsilə aktivləşdirmək olar:

Lazımi üsulları Stripe Dashboard → Settings → Payment methods bölməsində aktivləşdirin.

6. Çay pulu#

Konfiqurasiya#

1. Filiallar → filial kartı → «Ümumi» sekmesi → «Çay pulu» açarı.
2. Necə işləyir:

Qonaq bunu necə görür#

Yeməklər seçildikdən sonra ödəniş zamanı:

Sifarişiniz: 45₾

Çay pulu əlavə edilsin?
[ 10% (4.50₾) ] [ 15% (6.75₾) ] [ 20% (9.00₾) ] [ Digər məbləğ ]
[ Çay pulsuz ]

CƏMİ: 49.50₾   [Ödə →]

Çay pulu hesabatları#

Maliyyə bölməsi:

• «İcmal» sekmesi — dövr üzrə ümumi çay pulu məbləği, əvvəlki ilə müqayisə ilə;
• «Satışlar» sekmesi — ofisiantlar üzrə çay pulu.

7. Hesabınıza ödənişlər#

Stripe pulu necə ödəyir#

Qonaq ödəyir → Stripe tutur → T+2 gün sonra → Pul hesabınızda

Cədvəlin konfiqurasiyası#

Stripe Dashboard → Settings → Payouts:

• Gündəlik (tövsiyə olunur)
• Həftəlik (həftənin konkret günü)
• Aylıq

8. Stripe komissiyaları#

9. Geri qaytarmalar#

Stripe vasitəsilə pulun geri qaytarılması iki yerdən başladılır — sifarişin necə xidmət göstərildiyindən asılı olaraq.

Onlayn mağaza geri qaytarmaları (RMA)#

1. Geri qaytarmalar bölməsi → müraciət kartı.
2. Geri qaytarma rejimini seçin: ilkin ödəniş üsuluna (Stripe), hədiyyə kartına (store credit) və ya dəyişdirməyə.
3. Maddələri qeyd edin (tam və ya qismən geri qaytarma) və malın anbara qaytarılıb-qaytarılmayacağına qərar verin.
4. Pul birbaşa səhifədən göndərilir; qonağın kartına adətən 5–10 iş günü ərzində gəlir.

Kassada geri qaytarmalar#

POS-da geri qaytarma qəbz üzrə rəsmiləşdirilir — tam və ya qismən, yenidən satışla dəyişdirmə də var. Kassa növbəsi bu zaman açıq olmalıdır.

Sifarişlər bölməsindəki sifariş kartında rəsmiləşdirilmiş geri qaytarmaların nişanları müraciətə keçidlə görünür.

10. Təhlükəsizlik#

PCI DSS#

• Cenaly kart məlumatlarını saxlamır — hər şeyi Stripe emal edir
• Stripe PCI Level 1 (ən yüksək səviyyə) kimi sertifikatlaşdırılıb
• Kart məlumatları şifrələnir və tokenləşdirilir

3D Secure#

• EU kartları üçün avtomatik 3D Secure yoxlaması (SCA/PSD2)
• Fırıldaqçılığı və çarcbəkləri azaldır
• Qonaq üçün: bank tətbiqində təsdiq

Radar (fırıldaqçılıqdan qorunma)#

Stripe Radar şübhəli əməliyyatları avtomatik bloklayır:

• Qeyri-adi alış patterni
• Qara siyahıdakı kartlar
• Geolokasiya anomaliyaları

11. Testləmə#

İstehsala keçməzdən əvvəl test edin:

Stripe test kartları#

CVV: istənilən 3 rəqəm. Tarix: istənilən gələcək. ZIP: istənilən.

Necə test etmək#

1. Qoşulma zamanı «Test rejimi» açarını seçin (hər provayderin öz açarı var).
2. Test açarlarından istifadə edin (pk_test_..., sk_test_...) — və həmin Stripe test rejimində yaradılmış webhook-dan.
3. Test sifarişi edin → test kartı ilə ödəyin.
4. Sifarişlər bölməsində sifarişin statusunu yoxlayın — «Ödənilib» olmalıdır.
5. Hər şey işlədikdə — provayderi «Döyüş» rejimində canlı açarlarla yenidən qoşun.

12. Alternativ provayderlər#

Stripe olmayan ölkələr üçün və ya əlavə olaraq — qoşulmağa artıq hazır:

Daha 94 provayder (Adyen, PayTR, ЮKassa, LiqPay, Mercado Pago, Razorpay və s.) artıq siyahıdadır, lakin boz rəngdə göstərilir — inteqrasiya hələ test edilir. Tam icmal — Ödəniş bölməsində.

İstənilən provayderin qoşulması: Tətbiqlər mağazası → «Maliyyə» kateqoriyası → provayder kartı → «Konfiqurasiya et», ya da adi yolla Filiallar → filial kartı → «Ödənişlər» sekmesi.

13. Tez-tez verilən suallar#

Pulumu nə vaxt alacağam?#

Ödənişdən 2 iş günü sonra (T+2). İlk ödəniş 7–14 gün çəkə bilər (Stripe hesabı yoxlayana qədər).

Qonaq nağd ödəmək istəyir — nə etməli?#

«Nağd» və «təhvil zamanı kartla» üsulları həmişə mövcuddur və ödəniş provayderi tələb etmir — qonaq onları çekautda seçir, hesablaşmanı isə kassir aparır. Bu zaman Stripe iştirak etmir; qəbz kassada vurulur, əgər sizdə fiskal avadanlıq qoşulubsa (bax: Fiskallaşdırma).

Həm Stripe, həm də BOG iPay qoşmaq olar?#

Bəli. «Ödənişlər» sekmesinde bir neçə provayderi eyni anda aktivləşdirmək olar — çekautda qonaq hər biri üçün provayderin adı ilə imzalanmış düymə görəcək.

Stripe hesabı bloklayıb — nə etməli?#

1. E-poçtu yoxlayın — Stripe səbəbi göndərir
2. Adətən əlavə yoxlama tələb olunur
3. Stripe Support ilə əlaqə saxlayın: support.stripe.com
4. Bloklanma müddətində alternativ provayderdən istifadə edə bilərsiniz

Komissiyanı necə minimuma endirmək olar?#

• EU kartları ilə ödənişi təşviq edin (2,9% əvəzinə 1,5%)
• Böyük məbləğlər üçün SEPA-dan istifadə edin (0,35€ fiks)
• Böyük dövriyyədə (>100K€/ay) — Stripe-dən fərdi plan tələb edin

14. Dəstək#

• Stripe: support.stripe.com
• Cenaly: support@cenaly.com → mövzu «Stripe / Ödəniş»
• Stripe Status: status.stripe.com (işləkliyin yoxlanması)