Stripe қосу

Stripe арқылы онлайн-төлемдерді қабылдау: карталар, Apple Pay, Google Pay.

1. Шолу#

Stripe — жаһандық төлем платформасы. Cenaly тізілімінде Stripe 46 елде қосуға қолжетімді. Cenaly + Stripe интеграциясы мүмкіндік береді:

• 💳 Төлем қабылдау карталармен (Visa, Mastercard, AmEx)
• 📱 Apple Pay / Google Pay — бір тиіспен төлеу
• 💰 Төлемдерді алу банк шотыңызға
• 🔄 Қайтарымдарды өңдеу әкімші панелінен
• 💵 Шайқақы — қонақ төлеу кезінде шайқақы қосады
• 📊 Есептер — толық қаржылық аналитика

2. Талаптар#

• ✅ Cenaly тіркелгісі (онлайн-төлем кез келген жоспарда қолжетімді, тегін жоспарды қоса)
• ✅ Stripe тіркелгісі (stripe.com сайтында тегін тіркелу)
• ✅ Төлемдерді алу үшін банк шоты (еліңіздің валютасында)
• ✅ Верификация үшін құжаттар (паспорт / ID, компания құжаттары)

Қолдау көрсетілетін елдер#

Stripe 46 елде қосуға ұсынылады:

3. Stripe тіркелгісін жасау#

1-қадам. Тіркелу#

1. stripe.com сайтына өтіңіз → Start now
2. Email енгізіп, құпиясөз жасаңыз
3. Email-ды растаңыз

2-қадам. Бизнесті верификациялау#

Stripe сұрайды:

Верификация әдетте 1–3 жұмыс күнін алады.

3-қадам. API-кілттерді алыңыз#

1. Stripe дашбордында: Developers → API keys
2. Көшіріңіз:
   • Publishable key (pk_live_...)
   • Secret key (sk_live_...)

4. Cenaly-ге қосу#

Өзіңіздің Stripe тіркелгіңіз қосылады: қонақтың ақшасы тікелей сіздің Stripe балансыңызға түседі, Cenaly оны ұстамайды.

Қолданбалар дүкені → «Қаржы» санаты → Stripe карточкасы → «Реттеу» ашыңыз — қосу блогы дүкеннің ішінде модаль терезе ретінде ашылады. Әдеттегі жол да жұмыс істейді: Филиалдар → филиал карточкасы → «Төлемдер» қойындысы («Қонақ төлемі» секциясы), Stripe карточкасының жанындағы «Қосу» түймесі.

Қосу шебері (ұсынылады)#

Қадамдық шебер (≈10 минут) бүкіл процестен өткізіп, Stripe дашбордында қайда басу керектігін көрсетеді:

1. Режимді таңдаңыз — тестілік немесе жұмыс режимі. Stripe-тегі режим мен Cenaly-дегі «Тестілік / Жұмыс» ауыстырғышы сәйкес келуі керек.
2. Кілттерді көшіріңіз — Developers → API keys: Secret key (sk_test_… / sk_live_…) міндетті, Publishable key (pk_…) — қалауыңызша.
3. Вебхук қосыңыз — Developers → Webhooks → Add endpoint, ал Endpoint URL өрісіне шебер «Көшіру» түймесімен беретін Cenaly вебхук мекенжайын қойыңыз. Вебхуксыз Stripe тапсырыстың төленгенін хабарламайды, сондықтан тапсырыс «күтілуде» мәртебесінде қалып қалуы мүмкін.
4. Оқиғаларды таңдаңыз — «Select events» блогында checkout.session.completed міндетті түрде қосыңыз (дәл осы тапсырыстың төленгенін растайды), ал кейінге қалдырылған төлем әдістері үшін тағы checkout.session.async_payment_succeeded және checkout.session.async_payment_failed қосыңыз. Содан кейін «Add endpoint» басыңыз. Бұл оқиғаларсыз вебхук жасалғанымен, төлем туралы хабарламайды.
5. Webhook signing secret (whsec_…) көшіріңіз — міндетті емес өріс, бірақ онымен хабарламалардың қолтаңбасын тексеру қосылады.
6. Қосу — енгізілген мәндер қорғалған бэкендке жіберіледі.

Қысқа нысан#

Егер Stripe-те не қайда орналасқанын білсеңіз, қосудың инлайн-нысанын ашып, сол өрістерді толтырыңыз: Secret key, Webhook signing secret (қосымша), Publishable key (қосымша) және режим ауыстырғышы.

5. Төлем әдістерін баптау#

Банк карталары#

Stripe қосылған кезде автоматты түрде қосылады:

• Visa / Mastercard — барлық елдер
• American Express — көптеген елдер
• Diners Club / Discover — таңдамалы түрде

Apple Pay және Google Pay#

Cenaly ішінде олар үшін жеке қосқыштар жоқ: төлем Stripe Checkout hosted-бетінде жүреді, сондықтан әмияндар Stripe жағында қосылады.

• Google Pay — Stripe қосылғаннан кейін бірден жұмыс істейді (Android, Chrome).
• Apple Pay — Stripe доменді растауды талап етеді: Settings → Payment methods → Apple Pay → Add new domain. Верификациядан кейін iOS/Safari құрылғыларында батырма пайда болады.

Басқа әдістер#

Stripe Dashboard арқылы қосуға болады:

Қажетті әдістерді Stripe Dashboard → Settings → Payment methods бөлімінде қосыңыз.

6. Шайпұл#

Баптау#

1. Филиалдар → филиал карточкасы → «Жалпы» қойындысы → «Шайпұл» қосқышы.
2. Ол қалай жұмыс істейді:

Қонақ мұны қалай көреді#

Тағамдарды таңдағаннан кейін төлем кезінде:

Сіздің тапсырысыңыз: 45₾

Шайпұл қосу керек пе?
[ 10% (4.50₾) ] [ 15% (6.75₾) ] [ 20% (9.00₾) ] [ Басқа сома ]
[ Шайпұлсыз ]

БАРЛЫҒЫ: 49.50₾   [Төлеу →]

Шайпұл бойынша есептер#

Қаржы бөлімі:

• «Шолу» қойындысы — кезеңдегі шайпұлдың жалпы сомасы, алдыңғы кезеңмен салыстырумен;
• «Сатылымдар» қойындысы — даяшылар бойынша шайпұл.

7. Шотыңызға төлемдер#

Stripe ақшаны қалай төлейді#

Қонақ төлейді → Stripe ұстап қалады → T+2 күннен кейін → Ақша шотыңызда

Кестені баптау#

Stripe Dashboard → Settings → Payouts бөлімінде:

• Күн сайын (ұсынылады)
• Апта сайын (аптаның нақты күні)
• Ай сайын

8. Stripe комиссиялары#

9. Қайтарымдар#

Stripe арқылы ақшаны қайтару екі жерден іске қосылады — тапсырыс қалай қызмет көрсетілгеніне байланысты.

Интернет-дүкен қайтарымдары (RMA)#

1. Қайтарымдар бөлімі → өтінім карточкасы.
2. Қайтару режимін таңдаңыз: бастапқы төлем әдісіне (Stripe), сыйлық картасына (store credit) немесе айырбастауға.
3. Элементтерді белгілеңіз (толық немесе ішінара қайтару) және тауарды қоймаға қайтару керек пе, соны шешіңіз.
4. Ақша тікелей беттен жіберіледі; қонақтың картасына әдетте 5–10 жұмыс күнінде келеді.

Кассадағы қайтарымдар#

POS жүйесінде қайтару чек бойынша рәсімделеді — толық немесе ішінара, қайта сатумен айырбастау да бар. Бұл кезде кассалық ауысым ашық болуы керек.

Тапсырыстар бөліміндегі тапсырыс карточкасында рәсімделген қайтарымдардың белгілері өтінімге сілтемесімен көрінеді.

10. Қауіпсіздік#

PCI DSS#

• Cenaly карта деректерін сақтамайды — барлығын Stripe өңдейді
• Stripe PCI Level 1 (ең жоғары деңгей) ретінде сертификатталған
• Карта деректері шифрланады және токенизацияланады

3D Secure#

• EU карталары үшін 3D Secure автоматты тексерісі (SCA/PSD2)
• Алаяқтық пен чарджбэкті азайтады
• Қонақ үшін: банк қолданбасында растау

Radar (алаяқтықтан қорғау)#

Stripe Radar күдікті транзакцияларды автоматты түрде бұғаттайды:

• Әдеттен тыс сатып алу үлгісі
• Қара тізімдегі карталар
• Геолокациялық ауытқулар

11. Тестілеу#

Өндіріске қоспас бұрын тестілеңіз:

Stripe тест карталары#

CVV: кез келген 3 цифр. Күні: кез келген болашақ күн. ZIP: кез келген.

Қалай тестілеу керек#

1. Қосқан кезде «Тест режимі» қосқышын таңдаңыз (ол әр провайдерде өзінше).
2. Тест кілттерін (pk_test_..., sk_test_...) пайдаланыңыз — және сол Stripe тест режимінде жасалған вебхукті де.
3. Тест тапсырыс жасаңыз → тест картасымен төлеңіз.
4. Тапсырыстар бөлімінде тапсырыс мәртебесін тексеріңіз — «Төленді» болуы керек.
5. Барлығы жұмыс істегенде — провайдерді «Жауынгерлік» режимдегі нақты кілттермен қайта қосыңыз.

12. Балама провайдерлер#

Stripe жоқ елдер үшін немесе қосымша ретінде — қосылуға дайын:

Тағы 94 провайдер (Adyen, PayTR, ЮKassa, LiqPay, Mercado Pago, Razorpay және т.б.) тізімде бар, бірақ сұр түспен көрсетіледі — интеграция әлі тестілуде. Толық шолу — Оплата бөлімінде.

Кез келген провайдерді қосу: Қолданбалар дүкені → «Қаржы» санаты → провайдер карточкасы → «Баптау», немесе әдеттегі жолмен Филиалдар → филиал карточкасы → «Төлемдер» қойындысы.

13. Жиі қойылатын сұрақтар#

Ақшаны қашан аламын?#

Төлемнен кейін 2 жұмыс күнінен соң (T+2). Бірінші төлем 7–14 күнге созылуы мүмкін (Stripe тіркелгіні верификациялағанша).

Қонақ қолма-қол төлегісі келеді — не істеу керек?#

«Қолма-қол» және «алған кезде картамен» тәсілдері әрқашан қолжетімді және төлем провайдерін талап етпейді — қонақ оларды чекаутта таңдайды, ал есеп айырысуды кассир жүргізеді. Бұл жағдайда Stripe пайдаланылмайды; егер сізде фискалды жабдық қосылған болса, чек кассада шығарылады (қараңыз: Фискализация).

Stripe пен BOG iPay-ды бірге қосуға бола ма?#

Иә. «Төлемдер» қойындысында бірден бірнеше провайдерді қосуға болады — чекаутта қонақ әрқайсысы үшін провайдер атауымен қол қойылған батырманы көреді.

Stripe тіркелгіні бұғаттады — не істеу керек?#

1. Email-ды тексеріңіз — Stripe себебін жібереді
2. Әдетте қосымша верификация қажет
3. Stripe Support-қа хабарласыңыз: support.stripe.com
4. Бұғаттау кезінде балама провайдерді пайдалануға болады

Комиссияны қалай азайтуға болады?#

• EU карталарымен төлеуді ынталандырыңыз (2,9% орнына 1,5%)
• Ірі сомалар үшін SEPA пайдаланыңыз (0,35€ фикс)
• Үлкен айналым кезінде (>100K€/ай) — Stripe-тен жеке жоспар сұраңыз

14. Қолдау#

• Stripe: support.stripe.com
• Cenaly: support@cenaly.com → «Stripe / Оплата» тақырыбы
• Stripe Status: status.stripe.com (жұмыс қабілеттілігін тексеру)