DEVELOPER PLATFORM
API Reference
El RapidCents API reference documents cada endpoint con its request schema, response schema y error cases: authorize y captura, anulación, reembolso, tokenize, manage clientes y stored credentials, query settlements y replay webhook (notificación HTTP) events. Calls run server a server over HTTPS con un clave secreta, un pinned Versión de API y un clave de idempotencia en anything ese changes state. Responses carry el resource state, un identificador de solicitud para tracing, y en failure un typed code. It es generated against el live interface.
- 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
Server a server, over HTTPS, authenticated con un clave secreta. It es el layer behind página de pago alojada, Rapid.js y el dashboard, so un pago created por any de those es readable y refundable mediante el same endpoints.
Qué usted send
UN JSON body plus headers: el clave secreta, el Versión de API su cuenta es pinned a, y un clave de idempotencia en anything ese changes state. El reference names each input y marks required against optional per endpoint.
Qué comes back
UN JSON object con el resource y its current state, un identificador de solicitud para tracing, y en failure un typed code con un machine-readable meaning. HTTP status classifies el outcome; el code inside el body es qué usted sucursal en.
Cuando a use it
Building server-side
Pago creation, captura, anulación y reembolso all run desde su backend con el clave secreta, que es el solo place un clave secreta belongs.
Reconciling finance systems
Liquidación endpoints expose lote, comisión y depósito records, so un accounting export ties un depósito back a la transacciones inside it rather than a autorización responses.
Automating back-office work
Cliente records, stored credentials y reembolsos son all addressable, so operations ese staff would otherwise do por hand en el dashboard puede run en un schedule.
Cómo a implement API Reference
Authenticate con su clave secreta over HTTPS y pin el Versión de API explicitly.
Send un clave de idempotencia con cada state-changing request, generated per logical operation.
Sucursal en typed error codes rather than parsing message strings.
Store el identificador de solicitud desde cada response alongside su own transacción record.
Reconcile against settlement records rather than authorization responses.
Qué fails, y cómo usted find out
A reused idempotency key
Reusing un key para un genuinely different operation returns el first result, que looks like el second charge silently disappeared. Derive el key desde el operation, no desde el cliente o el session.
Una autorización ese es never captured
It expires inside el emisor window y el hold es released. Nothing settles, so un fulfilment pipeline ese waits para un captura evento will simply stop, con no error a catch.
Throttling treated as an outage
Exceeding el limits applied a su cuenta returns un documented status con un retry hint, no un dropped request. Backing off en ese signal es el fix; hammering it es qué turns it into un incident.
Sandbox versus production
Same endpoints, same schemas
Entorno de pruebas (sandbox) es no un reduced surface. El endpoints, el request bodies y el error codes son el ones usted will call en production, que es qué makes un entorno de pruebas (sandbox) regression suite worth keeping.
Deterministic declines
UN production decline depends en el emisor y puede change entre attempts. En entorno de pruebas (sandbox) la tarjeta de prueba fixes el outcome, so un test asserting un specific error code stays green para el right reason.
Liquidación usted do no have a wait para
Lote, comisión y depósito records appear en un accelerated schedule so conciliación code puede ser exercised en un single test run instead de across un funding cycle.
Questions about API Reference
Cómo does idempotencia work en el RapidCents API?
Supply un clave de idempotencia en pago creation y un retry con el same key returns el original result instead de charging twice, que makes network timeouts safe a retry.
Qué happens cuando un pago es authorized but never captured?
La autorización expires within el emisor’s window y el held funds return a el titular de la tarjeta. Nothing settles y no comisión applies a el expired autorización.
Son there rate limits?
Yes, applied per cuenta. Exceeding them returns un documented status code con un retry hint rather than dropping el request silently. El reference documents el limits ese apply y cómo un response signals one has been hit.
Should I read un pago result desde el Respuesta de API o desde un webhook (notificación HTTP)?
Both, para different reasons. El response es el synchronous outcome y es qué el cliente waits en. El webhook (notificación HTTP) es el durable record de cada later state change, including reembolsos, disputes y funding, y es qué su libro contable should follow.
Cómo do I trace one transacción end a end?
Keep el identificador de solicitud desde el creating call, el identificador de evento de each webhook (notificación HTTP) usted processed, y la liquidación record el pago landed en. Those three identifiers let Soporte follow un single attempt sin reproducing it desde un description.
Qué es el difference entre voiding y refunding?
UN anulación cancels una autorización antes de it settles, so el titular de la tarjeta never sees un completed charge. UN reembolso returns money después de liquidación y appears as un separate credit. Que one applies depends en dónde el pago es en its lifecycle, no en qué usted prefer.
Puede I reembolso un pago el API did no create?
Yes. Pagos taken mediante página de pago alojada, un enlace de pago, Rapid.js, una terminal o el dashboard son all readable y refundable mediante el same endpoints, because they land en one cuenta de comerciante rather than en separate systems.
Cómo do partial captures y partial reembolsos work against one autorización?
Captura y reembolso son separate operations en el pago, y each takes its own clave de idempotencia derived desde ese operation. Qué remains available depends en el pago’s current state, que el response reports, y el endpoint page states que transitions el resource allows.
Continue el integration
A RapidCents server-to-server request being signed on a developer desk, with a sandbox terminal for the in-person counterpart. Authentication
API keys, OAuth para partners y request signing para server-a-server integrations.
ExploreA typed RapidCents API error on screen, next to the declined sandbox terminal sale that produced it. Errors
Typed error codes, retry guidance y idempotencia patterns para production reliability.
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.
ExploreA RapidCents SDK project running a test payment, with the same sale visible on a sandbox terminal. SDKs
Official SDKs para Node.js, Python, PHP y mobile con typed models y retry helpers.
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
