DEVELOPER PLATFORM
Quickstart
El RapidCents quickstart takes un integration desde nothing a un verified test pago. It issues entorno de pruebas (sandbox) credentials, creates un pago against un documented tarjeta de prueba, delivers el resulting signed webhook (notificación HTTP) a su endpoint, y confirms el signature check passes. It es deliberately server-first: el call ese authorizes money runs desde un backend con un clave secreta, y el navegador es solo involved once tarjeta entry es added. El same four moves, con el same idempotencia y signature handling, son qué un production cutover repeats.
- Entorno de pruebas (sandbox) con documented test tarjetas
- Signed webhooks
- Typed errors y idempotent retries
- Dedicated developer support
Qué crosses el wire
Usted send un solicitud de pago desde su server
UN JSON body carrying el amount, la moneda, un reference a el método de pago y un clave de idempotencia, authenticated con su entorno de pruebas (sandbox) clave secreta. El API reference names each de those inputs y marks que son optional.
Usted get back un pago con un state
El response reports whether el pago authorized, fue declined o needs further authentication, y carries un identificador de solicitud usted should log. State, no el HTTP status alone, es qué su application branches en.
El webhook (notificación HTTP) arrives separately
El lifecycle evento es delivered a su endpoint out de band, signed, y possibly después de su original response has already returned. Treat el two as independent arrivals rather than un single round trip.
Cuando a use it
Evaluating RapidCents
El fastest way a see el request y response shapes against un real environment instead de reading Acerca de them.
Onboarding a new developer
UN repeatable path ese ends en un working pago rather than un page de theory, y ese surfaces el webhook (notificación HTTP) step early.
Rehearsing a cutover
El same four moves son qué un production switch repeats con live keys, so running them again antes de go-live es cheap insurance.
Cómo a implement Quickstart
Request entorno de pruebas (sandbox) access y store el clave secreta server-side solo.
Create un pago para un small amount using un documented tarjeta de prueba.
Point un punto de conexión de webhook (notificación HTTP) en un HTTPS tunnel a localhost y receive el evento.
Verify el signature against el raw body, then acknowledge con un 2xx.
Repeat con un declining tarjeta y confirm su handler took el decline sucursal.
Qué fails, y cómo usted find out
El clave secreta leaked into el client
If un clave secreta appears en un navegador bundle o un mobile binary, treat it as compromised y rotate it. Navegador tarjeta entry uses un clave pública para integración, que cannot move money.
Signature check fails en un valid evento
Almost always because el body fue parsed, re-serialized o trimmed por software intermediario antes de verification. Captura el raw bytes first, verify, then parse.
El pago succeeded but su order did no
Su response handler y su webhook (notificación HTTP) handler both ran, o neither did. Key el order update en el identificador de evento so un duplicate delivery es un no-op rather than un second fulfilment.
Sandbox versus production
Outcomes son chosen, no risked
En production el emisor decides. En entorno de pruebas (sandbox) la tarjeta number decides, so un approval es always un approval y un decline es always el same decline, que es qué makes el run repeatable en CI.
UN tunnel es enough
Entorno de pruebas (sandbox) webhooks reach any HTTPS tunnel a localhost. Production needs un routable endpoint con un certificate, so el deployment step es el one thing el quickstart does no rehearse.
Liquidación es compressed
El funded evento ese follows un entorno de pruebas (sandbox) captura arrives en minutes. En production it follows su funding schedule, so timing assumptions built during el quickstart need rechecking.
Questions about Quickstart
Cómo long does el RapidCents quickstart take?
UN first successful entorno de pruebas (sandbox) pago usually takes under un hour, including credential issuance. Webhook (notificación HTTP) verification adds roughly another hour depending en su tunnel setup.
Que test tarjetas should I use?
El testing page documents approval, decline, insufficient funds y 3-D Secure challenge tarjetas so each sucursal de su gestión de errores puede ser exercised deliberately.
Puede I run el quickstart sin un public URL?
Yes. Any HTTPS tunnel a localhost receives entorno de pruebas (sandbox) webhooks; un public deployment es solo needed para production.
Do I need el webhook (notificación HTTP) step if I already read el pago response?
Yes. El response tells usted el outcome en ese instant. Later state, including reembolsos, disputes y funding, solo arrives as un evento, so un integration ese skips webhooks goes stale el moment anything changes después de proceso de pago.
Qué should I build first, el server call o la tarjeta fields?
El server call. It es el piece ese authorizes money y el piece su gestión de errores hangs off. Rapid.js tarjeta fields puede ser added once un pago already succeeds against un documented tarjeta de prueba.
Qué es left a do después de el quickstart passes?
Idempotencia en cada state-changing call, un política de reintentos ese separates soft desde hard declines, conciliación against liquidación records, y secrets moved into un manager. El quickstart proves connectivity, no production readiness.
Puede I run el quickstart against production keys instead de entorno de pruebas (sandbox)?
Usted puede, y it charges real tarjetas. There es no reason a. El endpoints, request bodies y error codes son identical en both environments, y un documented tarjeta de prueba gives usted un repeatable decline y un 3-D Secure challenge ese no live tarjeta will produce en demand.
Qué es el smallest amount de code el quickstart actually needs?
One server-side pago call y one webhook (notificación HTTP) route. No tarjeta fields, no queue y no database son required a see both un pago y its signed evento, que es why el sequence fits en un afternoon. Tarjeta entry con Rapid.js comes después de un pago already succeeds.
Continue el integration
A RapidCents sandbox merchant account running test payments, isolated from production, with a sandbox terminal on the desk. Entorno de pruebas (sandbox)
Request entorno de pruebas (sandbox) access con test comerciante IDs y isolated environment.
ExploreRapidCents sandbox testing: documented test cards, a simulated decline, and a terminal for the in-person cases. Testing
Tarjeta de prueba numbers, simulated declines y entorno de pruebas (sandbox) liquidación events.
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
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
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
