Sviluppatori

Un'unica API.
Ogni acquirente.

Integralo una volta. Cardflo instrada ogni transazione attraverso la nostra rete di acquisizione, nessun codice aggiuntivo quando aggiungi un nuovo provider, nessun cambiamento distruttivo quando i percorsi cambiano.

create-payment.ts
// Create a payment, one API, every acquirer
const payment = await cardflo.payments.create({
  amount: 4999,            // £49.99
  currency: "GBP",
  customer: { id: "cus_8aF2..." },
  method: { type: "card", token: "tok_live_..." },
  // Smart routing picks the best acquirer automatically.
  routing: { strategy: "approval_then_cost" },
});

if (payment.status === "approved") {
  // Webhook payment.succeeded will follow.
}
Kit di strumenti

Tutto ciò di cui hai bisogno per spedire pagamenti velocemente.

API REST

Risorse prevedibili, scritture idempotenti e JSON-everywhere.

Checkout ospitato

Integrabile, con ambito PCI, personalizzabile per adattarsi al Suo marchio.

Webhook

Eventi firmati per ogni pagamento, rimborso e disputa.

Token di vault e di rete

Carte cliente portatili con gestione del ciclo di vita dei token.

SDK del server

Clienti con tipizzazione, con Node, Python, Go e PHP, con tentativi di ripristino integrati.

Plugin

WooCommerce, Magento, Shopify e Salesforce Commerce Cloud.
Webhook

Eventi in tempo reale per ogni ciclo di vita del pagamento.

Firmato, ritentato con backoff esponenziale e idempotente per ID evento. Iscriviti a ciò che ti interessa, ignora il resto.

  • payment.succeededAcquisito dall'acquirente instradato
  • payment.retriedRifiuto blando, prossimo acquirente
  • payment.failedTutte le rotte esaurite
  • refund.createdAvviato per l'acquisizione
  • dispute.openedChargeback ricevuto
  • payout.completedLiquidato alla Sua banca

Cardflo espone un'API REST, un flusso di webhook, un iframe di checkout ospitato e una libreria crescente di componenti drop-in. Tutto è versionato, idempotente per impostazione predefinita e copre le stesse primitive sia che Lei stia integrando un acquirer o cinque. La documentazione, le chiavi sandbox e una raccolta Postman sono pubbliche.

Come i team si integrano

Checkout ospitato

Il percorso più veloce per la produzione. Reindirizza o incorpora il nostro iframe con ambito PCI, ricevi un webhook al completamento. Ambito PCI zero, portafogli inclusi, token di rete attivi per impostazione predefinita. La maggior parte delle integrazioni viene spedita in un giorno e copre il 90 percento dei casi d'uso.

API diretta

Controllo completo sui flussi di autorizzazione, acquisizione, rimborso e contestazione. Ambito PCI DSS SAQ D. Adatto per carte memorizzate, abbonamenti, marketplace e qualsiasi prodotto che richieda una logica personalizzata attorno all'autenticazione. SDK di riferimento per Node, Python, Ruby, Go e PHP.

Webhook ed eventi

Idempotente, sicuro per i tentativi di ripetizione, firmato con HMAC. Ogni pagamento, rimborso, storno, aggiornamento KYB e regolamento è un evento webhook. La sandbox Le consente di riprodurre gli eventi senza toccare la produzione, il che rende banale il test di automazione end-to-end.

FAQ

Domande frequenti

Integrazione, SDK, webhook, sandbox, migrazione e SLA. Le risposte pratiche che gli ingegneri chiedono prima di scrivere la prima riga di codice.

Ho bisogno di un'integrazione separata per ogni acquirente?

No. Un'API REST di Cardflo e un set di webhook La connettono a ogni banca acquirer nella rete. L'instradamento intelligente sceglie la banca acquirer per transazione e Lei non dovrà mai scrivere codice specifico per l'acquirer. Aggiunga o sostituisca le banche acquirer in background senza modificare la Sua base di codice.

Come funzionano i webhook e l'idempotenza?

I webhook sono firmati con HMAC-SHA256 e consegnati con tentativi automatici e backoff esponenziale. Ogni richiesta accetta una chiave di idempotenza, quindi le creazioni riprovate restituiscono il pagamento originale invece di duplicare gli addebiti. Gli eventi includono payment.succeeded, payment.retried, refund.created e dispute.opened.

Avete SDK e componenti UI ospitati?

Sì. SDK del server per Node, Python, PHP, Ruby, Go e .NET. Un checkout ospitato drop-in, Elements per l'acquisizione di carte incorporate e un'API Payment Links per flussi senza codice. Tutti i componenti UI riducono l'ambito PCI in modo da non dover gestire i dati delle carte.

Qual è la storia del sandbox e delle carte di prova?

L'ambiente di prova rispecchia la produzione con carte di test per ogni circuito, codici di negazione forzata per ogni codice di risposta da noi supportato e sfide 3DS simulate. Può riprodurre i webhook di produzione reali nell'ambiente di prova per testare i casi limite senza influire sul traffico reale.

Come migro da Stripe, Adyen o Checkout.com?

Gli intenti di pagamento, i clienti, i rimborsi e le contestazioni si mappano chiaramente agli equivalenti Cardflo e supportiamo l'importazione dei token delle carte laddove lo schema lo consenta. Forniamo un ingegnere per la migrazione, documenti di mappatura dei campi affiancati e una modalità di prova per monitorare il traffico prima di passare al flusso primario.

Quali sono i vostri limiti di tariffa e gli SLA di uptime?

I limiti di frequenza dell'API pubblica partono da 100 richieste al secondo per account, superiori su richiesta. Pubblichiamo una disponibilità del 99,99% sull'API transazionale con crediti mensili in caso di mancato raggiungimento. Lo stato è disponibile in tempo reale su status.cardflo.io con cronologia degli incidenti e RSS.
Richiedi ora