Ce primesti
Implementare corecta a payload-ului JWT HS512 semnat cu secret-ul tau Twispay, request canonic catre endpoint-ul secure.twispay.com cu orderId unic idempotent. Folosim library oficiala recomandata (jose pentru Node, firebase/php-jwt pentru PHP). Documentat clar in repository ce semneaza si de ce.
Handler robust pentru callback async de la Twispay cu verificare HMAC SHA512 pe raw body (nu pe JSON parsed). Logging complet, idempotency check pe orderId, response 200 imediat dupa save in DB. Tratare corecta pentru status confirmed, paid, canceled, refunded, charged-back.
Buton refund in panou admin care apeleaza REST API Twispay pentru rambursare partiala sau totala. Audit trail complet (cine, cand, suma), webhook refund.completed pentru update status comanda. Integrare cu SmartBill pentru stornare factura automata daca e cazul.
Setup abonamente recurente cu billing automat la interval definit (lunar, anual). Webhook handler pentru subscription.created, subscription.renewed, subscription.failed cu retry policy 3x. Card update automat la expirare cu account updater. Ideal pentru SaaS sau servicii recurente.
Pentru marketplace-uri cu vendori multipli: split automat al sumei catre conturile bancare ale vanzatorilor cu fee retinut pentru platforma. Configurare per tranzactie a procentajelor, decontare T+2 in conturile fiecaruia. Echivalent functional cu Stripe Connect, dar cu KYC EU.
Forced 3DS 2.x pentru toate cardurile EU conform PSD2 SCA. Hosted Payment Page = zero scope PCI pentru tine (Twispay e PCI DSS Level 1). Daca alegi JS Direct, implementare cu Twispay.js pentru tokenizare in browser, datele card nu trec niciodata prin serverul tau.
Pe trigger callback paid, generare automata factura SmartBill cu datele clientului si trimitere catre ANAF e-Factura (RO e-Invoicing obligatoriu B2B). Email confirmare client cu PDF atasat. Tracking series si numar factura in dashboard. Reconciliere zilnica intre settlement Twispay si facturi emise.
Mediu sandbox Twispay functional pentru testare cu carduri 4111 1111 1111 1111 si scenarii 3DS pass/fail. Cod sursa livrat in repository (Git tau sau al nostru), comentarii pe punctele critice, README cu deploy steps, .env.example pentru chei. Tu detii integrarea, nu te legam de noi.
Cum functioneaza
Zilele 1-3
Te ajutam cu aplicatia merchant online Twispay: documente firma (Certificat Constatator ONRC, CUI), IBAN EUR sau RON pentru settlement, descriere business si flow de vanzare. KYC online rapid, aprobare 2-3 zile lucratoare (mult mai rapid decat NETOPIA care cere 5-10 zile). Primesti credentialele sandbox imediat dupa contract.
Zilele 4-6
Setup JWT signing cu library recomandata, route POST catre secure.twispay.com cu jsonRequest payload (amount, currency, orderId, customer), callback handler cu HMAC SHA512 verification pe raw body, IPN reconciliation cron job. Pentru marketplace: configurare split rules. Pentru recurring: webhook handlers complete.
Zilele 7-8
Test end-to-end cu carduri Twispay sandbox: 4111 1111 1111 1111 (success), 4000 0000 0000 0002 (declined), 4000 0000 0000 0341 (3DS challenge). Scenarii: plata simpla, 3DS pass/fail, callback delayed, refund partial, abonament recurring failed. Tot trafic logat pentru audit.
Ziua 9
Switch credentiale sandbox catre productie, prima tranzactie reala 1 EUR pentru validare, monitorizare callbacks 48h post-launch cu alertare automata. Daca apare orice anomalie (callback failure, signature mismatch), fix in max 2h. Dashboard tranzactii Twispay configurat pentru echipa ta.
Zilele 10+
30 zile bug-fix gratuit, raspuns email 24h, fix critic 4h SLA. Optional pachet mentenanta 50€/luna cu monitoring Healthchecks.io, update SDK la versiuni noi, audit security semestrial. Raport reconciliere lunar settlement vs facturi emise pentru e-commerce serioase.
Stack suportat
Plugin oficial Twispay free, intretinut activ. Config 2-3 ore daca tema nu e personalizata exotic. Suporta recurring via WooCommerce Subscriptions.
Gateway alternativ via Custom Payment Method + middleware Cloudflare Worker. Shopify nu accepta Twispay nativ ca payment provider direct in lista.
Module comunitare existente, customizate la nevoie. Configurare in 1 zi pentru shop standard, mai mult daca ai checkout custom.
Extensie comunitara + adapter custom pentru flow JWT. Pentru Magento Enterprise recomandam integrare directa API in custom module.
Implementare directa Route Handlers App Router. JWT signing cu jose, callback verification in API route. Cel mai curat din punct de vedere arhitectural.
API routes Astro catre backend Node sau direct catre Twispay daca folosesti adapter SSR (Vercel, Cloudflare, Node).
REST API catre backend Node/PHP separat sau direct in WordPress cu plugin oficial daca frontend-ul tau apeleaza WP REST.
SDK PHP oficial Twispay sau implementare manuala cu firebase/php-jwt. Funcioneaza pe orice Laravel, Symfony, CodeIgniter sau PHP plain.
Preturi integrare
300€
livrare 5-7 zile
750€
livrare 10-14 zile
1500€+
livrare 21-30 zile
Intrebari frecvente
Twispay practica fees procentuale: 1.4-1.8% pentru carduri SEPA emise in EU (Romania inclusiv), 2.0-2.2% pentru carduri non-EU (US, UK, Asia) si AmEx, plus o taxa fixa per tranzactie ~0.15-0.20 EUR. Setup gratuit, fara abonament lunar pentru conturi standard. Pentru volume peste 50.000 EUR/luna se pot negocia fees blended sub 1.5%. Tranzactiile esuate, 3DS abandonate si refund-urile sunt gratuite. Decontare T+2 in cont EUR sau RON via SEPA. Spre comparatie cu NETOPIA (1.6-2% pe carduri RO) sau Stripe (1.5% + 0.25 EUR), Twispay e competitiv mai ales daca incasezi mult din UE non-RO.
Twispay: procesator licentiat in Cipru cu sediu EU, ideal daca facturezi multi-currency in EU si vrei un singur PSP pentru 100+ valute. Suporta marketplace split-payments nativ (Stripe Connect echivalent) si recurring subscriptions out-of-the-box. NETOPIA (fost mobilPay): cel mai potrivit strict pentru piata RO, integrari directe SmartBill, suport in romana, fees 1.6-2% pe carduri locale. Stripe: best UI/UX, API curat, Stripe Radar, dar decontare USD/EUR (nu RON nativ). Recomandare: Twispay pentru e-commerce EU multi-currency sau marketplace cu vendori multipli, NETOPIA pentru strict RO simplu, Stripe pentru SaaS B2B international.
Pentru un magazin standard: 5-10 zile lucratoare end-to-end. Etape: ziua 1-3 onboarding cont Twispay (KYC online rapid, contract, IBAN EUR/RON, configurare merchant in dashboard, aprobare 2-3 zile lucratoare), ziua 4-6 implementare tehnica (POST secure.twispay.com cu JWT jsonRequest, callback HMAC SHA512 verification, IPN handler), ziua 7-8 testare sandbox cu carduri de test 4111 1111 1111 1111 si scenarii 3DS, ziua 9 trecere live cu monitorizare 48h. Primesti cod sursa documentat, sandbox functional, dashboard configurat, GDPR cookie consent, training 1h, 30 zile suport bug-uri.
Integrarea completa acopera: 1) Initiere plata (POST secure.twispay.com cu payload JWT semnat HS512 ce contine jsonRequest cu suma, valuta, orderId unic, customer data). 2) Hosted Payment Page sau JS Direct embedded checkout (alegere in functie de UX dorit). 3) 3DS 2.x SCA automat pentru carduri EU. 4) Callback async POST cu signature HMAC SHA512 pe care backend-ul tau o verifica. 5) IPN reconciliation periodica via REST API GET /order/{id}. 6) Update comanda in ERP/CRM. 7) Email confirmare cu factura SmartBill atasata. 8) Refund partial sau full via REST API. 9) Recurring subscriptions cu billing automat. 10) Logging complet pentru audit ANAF si reconciliere bancara.
Suportam orice. WooCommerce: plugin oficial Twispay (free, intretinut), config in 2-3 ore daca tema nu e exotica. Shopify: gateway alternativ via Custom Payment Method + middleware Cloudflare Worker (Shopify nu accepta Twispay nativ). PrestaShop si Magento: module comunitare existente, customizate la nevoie. Next.js custom: implementare directa cu Route Handlers App Router, JWT signing cu jsonwebtoken sau jose, callback verification in API route. Astro si WordPress headless: API routes catre backend Node/PHP. PHP custom: SDK PHP oficial Twispay sau implementare manuala cu firebase/php-jwt. Pentru marketplace cu split, recomandam stack custom.
Top 5 erori vazute: 1) JWT signature invalida (HS512 calculat cu secretul gresit sau payload neserialized canonic) — fix: foloseste exact library oficiala recomandata, jose pentru Node, php-jwt pentru PHP. 2) Callback HMAC failure (verificare incorect implementata, body parsed inainte de verificare) — fix: salveaza raw body inainte de JSON.parse pentru recalcul HMAC. 3) orderId duplicat (regenerat la refresh sau retry client) — fix: idempotency key persistent in baza. 4) Recurring subscriptions cu carduri expirate netratate — fix: webhook subscription.failed handler cu retry policy. 5) Reconciliere lipsa intre Twispay settlement T+2 si comenzi paid — fix: export zilnic CSV via API si match pe orderId.
Da, suport tehnic real cu SLA scris. Pachet baza: 30 zile bug-fix gratuit post-livrare, raspuns email max 24h, fix critic (plati blocate, callback netratat) max 4h interventie. Pachet mentenanta lunara 50€/luna: monitoring endpoint callback cu Healthchecks.io, alertare automata Slack/email daca rata de plati esuate creste peste 5%, update SDK Twispay cand publica versiuni noi, audit security semestrial, suport prioritar 4h SLA. Pentru e-commerce mari peste 1000 tranzactii/luna recomandam pachet Custom 150€/luna cu monitoring 24/7, on-call si raport reconciliere lunar.
Twispay NU e potrivit pentru: 1) Magazine strict RO cu carduri locale predominant — NETOPIA are fees mai mici pe BCR/BT/ING si integrari SmartBill native fara configurare. 2) SaaS B2B cu plati USD si clienti predominant US — Stripe e clar superior pentru USD multi-currency. 3) Plati BNPL Tbi/Twisto sau rate fara dobanda — PayU Romania are integrari directe pe care Twispay nu le replica. 4) Crypto sau metode exotice — Twispay e card-centric. 5) Volume foarte mari peste 1M EUR/luna in RO — negociaza direct cu Libra Pay sau POS virtual bancar pentru fees sub 1%. Pentru e-commerce EU mid-market si marketplace, Twispay ramane recomandarea principala.
Integrari conexe
Hub central cu toti procesatorii: NETOPIA, Twispay, Stripe, EuPlatesc, PayU. Comparativ fees, decontare, suport stack.
Alternativa internationala cu API curat si Stripe Radar. Bun pentru SaaS B2B cu plati USD/EUR multi-currency.
Procesator RO consacrat (fost mobilPay) cu fees mici pe carduri locale si integrari SmartBill native.