DEVELOPER PLATFORM
RapidCents APIs
El RapidCents APIs son el programmable surface de la plataforma de pagos: REST Recursos para pagos, reembolsos, clientes, stored credentials, tokens y liquidación, over HTTPS con JSON bodies. They son el same interface el dashboard, página de pago alojada y embedded fields run en, so un sale taken en una terminal, mediante un link o desde su own code becomes el same kind de record. Four guarantees hold throughout: environment-scoped keys, idempotent money movement, typed error codes, y un signed webhook (notificación HTTP) para later changes.
- Entorno de pruebas (sandbox) con documented test tarjetas
- Signed webhooks
- Typed errors y idempotent retries
- Dedicated developer support
Qué crosses el wire
Dónde it sits
Behind everything. Su server calls it directly; Rapid.js reaches it con un clave pública para integración a create un token; una terminal sale y un dashboard reembolso land en el same records. There es one cuenta, one vault y one liquidación view underneath all de them.
Qué usted send
UN JSON body, un clave secreta, el Versión de API usted son pinned a, y un clave de idempotencia en anything ese moves money. Amounts, moneda, el método de pago reference y su own order reference son el inputs most calls need; el reference names each field exactly.
Qué comes back
El resource y its current state, plus un identificador de solicitud. Read el state rather than assuming un 2xx means approved, y keep el identificador de solicitud: it es el solo thing ese makes un single attempt traceable afterwards.
Cuando a use it
Building su own proceso de pago
Cuando el pago step has a live inside su product y follow su own rules Acerca de carts, taxes, depósitos o partial fulfilment.
Automating operations
Reembolsos, cliente records y stored credentials son all addressable, so work ese would otherwise ser done por hand en el dashboard puede run en un schedule.
Feeding finance systems
Liquidación Recursos expose el lote, la comisiones y el depósito, que es qué lets un libro contable entry ser written against money ese actually arrived rather than against una autorización.
Cómo a implement RapidCents APIs
Get entorno de pruebas (sandbox) credentials y pin un Versión de API explicitly en su client.
Create un pago server-side con un clave de idempotencia derived desde el operation.
Register un punto de conexión de webhook (notificación HTTP) y verify signatures antes de acting en any evento.
Map cada typed error code a un action, con unknown codes failing closed.
Reconcile against liquidación records, then move a production keys.
Qué fails, y cómo usted find out
Treating el HTTP status as el outcome
UN call puede succeed y el pago still ser declined. El state en el body es el answer, y reading el status alone es cómo declined orders get fulfilled.
Polling instead de listening
Repeatedly reading un pago a see whether anything changed es slower than el webhook (notificación HTTP), heavier en su rate limits, y still misses reembolsos y disputes raised outside su application.
Idempotencia keys derived desde el wrong thing
UN key tied a un cliente o un session collapses two genuine purchases into one. Derive it desde el operation, store it con su record, y reuse it solo cuando retrying ese exact attempt.
Reconciling against authorizations
Authorizations expire, get voided y get partially captured. UN finance process built en them disagrees con el banco; one built en liquidación records does no.
Sandbox versus production
El same surface, smaller consequences
Entorno de pruebas (sandbox) exposes el same Recursos con el same schemas. Qué changes es ese outcomes follow la tarjeta de prueba, liquidación es compressed, y nothing ese happens es money.
Rate limits still apply
Entorno de pruebas (sandbox) es no un load environment. Limits exist there too, so un test suite ese hammers el API will meet el same limitación de solicitudes response su production code needs a handle anyway.
Availability es scoped a el gateway
El gateway API carries un 99.9% tiempo de disponibilidad service level en production. Entorno de pruebas (sandbox) es provided para development y es no el environment ese commitment describes.
Questions about RapidCents APIs
Qué puede el RapidCents APIs do ese el dashboard cannot?
Everything el dashboard does, en un schedule y en volume, plus el parts su own product needs a own: un proceso de pago ese follows su cart rules, reembolsos triggered por su fulfilment system, y exports shaped para su libro contable rather than para un screen.
Do I need un separate integration para en línea y en persona pagos?
No. Terminal, página de pago alojada, enlace de pago y API pagos land en el same cuenta y appear en el same records, so reporting, reembolsos y conciliación son one integration rather than several.
Cómo do I avoid double-charging un cliente en un network timeout?
Send un clave de idempotencia con el original request y reuse ese exact key en el retry. El second call returns el first result instead de creating un second pago, que es qué makes un unknown outcome safe a retry.
Puede I store tarjeta numbers if I want full control?
Usted puede hold un token instead, y el practical answer es ese usted should. Posting raw tarjeta data directly puts su systems en el widest PCI assessment; tokenizing mediante un RapidCents-hosted surface keeps el credential out de su environment entirely.
Qué es el fastest way a know un API change affects me?
Pin su version, subscribe el changelog a un channel someone reads, y record que version each de su services sends. Those three things turn un cambio incompatible con versiones anteriores into un scheduled ticket.
Dónde do I find rate limits y exact field names?
En el API reference, per endpoint. Este page describes el shape de el surface y el guarantees ese hold across it; el reference es el contract y es el document a trust.
Cómo do I know un pago settled rather than solo authorized?
Read la liquidación Recursos rather than la autorización. They expose el lote, la comisiones deducted y el depósito, que es qué lets un libro contable entry ser written against money ese actually arrived. Authorizations expire, get voided y get partially captured, so un finance process built en them will disagree con el banco.
Qué should my code do con un error code it does no recognise?
Fail closed. Map cada typed error code usted know a un specific action, y treat anything unknown as un failure rather than as un success por incumplimiento de pago. UN new code appearing en production should stop el operation y raise un alert, no fall mediante un sucursal ese assumes approval.
Continue el integration
The RapidCents API reference on a workstation, with a sample request, the matching response, and a test terminal. API Reference
REST endpoints para pagos, clientes, reembolsos, webhooks y settlements con request y…
Explore
A RapidCents webhook delivery timeline next to the payment that triggered it, with a test terminal on the desk. Webhooks
Signed webhook (notificación HTTP) events para pago lifecycle con idempotent procesamiento guidance.
Explore
Rapid.js hosted card fields on a developer workstation, keeping card entry out of the merchant's PCI scope. Rapid.js
Embedded pago components para el web ese keep tarjeta entry inside RapidCents-campos de pago alojados…
Explore
The RapidCents tokenization API returning a card token, so merchant software never stores the PAN. Tokenization API
Create, reuse y retire pago tokens programmatically so su systems never store tarjeta…
Explore
Take the next step
Talk a un RapidCents specialist
RapidCents Análisis de comisiones reads un estado de cuenta de procesamiento y shows intercambio interbancario separately desde el markup. Upload un estado de cuenta para un instant breakdown, o open una cuenta de comerciante y start accepting pagos en one cuenta.
- No obligation
- Payment specialists, not a call centre
- Secure statement upload
