Desarrolle sobre API diseñadas para producción
La API de RapidCents atiende a equipos de ingeniería que agregan pagos a un producto existente, al desarrollador que decide la arquitectura de pagos y a equipos que dejan otra pasarela con una transición que debe seguir siendo reversible. Las integraciones con pasarelas fallan en los mismos tres lugares: reintentos que cobran doble, webhooks que nadie verificó y un manejo de rechazos escrito a partir de un ejemplo de la documentación y no de un rechazo real. La forma de la superficie de la API importa menos que poder responder esos tres puntos desde la referencia.
- Especialistas en pagos
- Precios de intercambio más margen
- Migración guiada
- Soporte posterior al lanzamiento
Para quién es esta solución
Equipos de ingeniería que integran el proceso de pago
Equipos que incorporan el pago a un producto existente, donde los modos de falla importan más que el escenario ideal.
Fundadores técnicos
Una sola persona que decide la arquitectura de pagos y necesita conocer las restricciones desde el principio y no después del lanzamiento.
Equipos que migran desde otra pasarela
Flujos existentes, credenciales guardadas y consumidores de webhooks ya en funcionamiento, y una transición que tiene que ser reversible.
Desafíos comunes
Reintentos que cobran dos veces
Un tiempo de espera agotado no es un rechazo. Sin idempotencia, el reintento seguro y el cobro doble se ven idénticos desde el cliente.
Webhooks sin verificar
Un punto de enlace que acepta cualquier POST es un punto de enlace al que cualquiera puede enviar datos. La verificación de firmas es la diferencia entre un evento y una afirmación.
Rechazos tratados como un solo caso
Un rechazo temporal que tendría éxito al reintentar y un rechazo definitivo que nunca lo tendrá requieren rutas de código distintas, lo que exige códigos de rechazo estructurados y no una cadena de mensaje.
El enfoque de RapidCents
Cree credenciales del entorno de pruebas y ejecute los flujos que realmente necesita con tarjetas de prueba.
Implemente la autorización y la captura como pasos separados si envía la mercancía después de cobrar.
Envíe una clave de idempotencia en cada escritura, para que una falla de red se pueda reintentar con seguridad.
Verifique las firmas de los webhooks y trate el webhook, y no la redirección del navegador, como la fuente de verdad del estado del pago.
Complete la lista de verificación de certificación y luego supervise el tráfico en vivo y la liquidación en el panel.
Capacidades recomendadas
API REST
Puntos de enlace para pagos, reembolsos, clientes, tokens y liquidación, con control de versiones para que una actualización sea una decisión y no una sorpresa.
Claves de idempotencia
Una escritura repetida con la misma clave devuelve el resultado original en lugar de crear un segundo cobro.
Webhooks firmados
Los eventos del ciclo de vida llevan una firma HMAC que su punto de enlace verifica antes de actuar sobre ellos.
Códigos de rechazo estructurados
Motivos legibles por máquina, para que la lógica de reintentos distinga un rechazo temporal de uno definitivo.
Campos integrados de Rapid.js
Campos de tarjeta alojados por RapidCents y con el estilo de su propio proceso de pago, lo que mantiene los datos de tarjeta fuera de sus servidores mientras la interfaz sigue siendo suya.
Productos relacionados
Un escritorio de integración de pasarela de pagos: respuesta de la API en pantalla y una terminal RapidCents lista para una venta de prueba. Pasarela de pagos
La pasarela de pagos de RapidCents expone endpoints REST para autorizar, capturar, anular, reembolsar y tokenizar…
Explorar
Campos de tarjeta alojados por RapidCents dentro del pago de un comerciante, con una terminal y el panel de pagos a su lado. Pagos integrados
Los pagos integrados de RapidCents ofrecen componentes de interfaz listos para usar, campos de tarjeta, botones de billetera y estado del pago…
Explorar
Enfoque de implementación
Entorno de pruebas (sandbox)
Credenciales y tarjetas de prueba antes de que exista cualquier llave de producción. Todos los flujos que ejecutará en producción se pueden probar primero allí.
Desarrollo de la integración
Autorización y captura, reembolsos, tokens de clientes y manejo de webhooks, escritos para la versión de la API con la que piensa salir a producción.
Certificación
Una lista de verificación que cubre los flujos que construyó, completada antes de emitir las credenciales de producción.
Supervisión después del lanzamiento
Tráfico en vivo, motivos de rechazo y liquidación visibles en el panel, para que la primera anomalía la encuentre usted y no la reporte un cliente.
Lo que no cambia
Su stack tecnológico
La API es REST sobre HTTPS. No se requiere ningún framework, entorno de ejecución ni SDK.
El diseño de su proceso de pago
Usted define el estilo de los campos de Rapid.js. Reducir el alcance de PCI no significa entregar la interfaz.
Su obligación de PCI
Los campos alojados y la tokenización reducen lo que queda dentro del alcance. No eliminan el requisito de validar en el cuestionario que corresponde a su integración.
Tarjetas, monedas y liquidación en Estados Unidos
Lo que acepta una cuenta de RapidCents en Estados Unidos, la moneda en que liquida y cuándo llega el dinero.
Tarjetas y métodos de pago aceptados
Tarjetas Visa, Mastercard, American Express, Discover, UnionPay y Diners Club de cualquier país, además de débito con PIN, Apple Pay, Google Pay y pagos bancarios ACH, en una sola cuenta de comerciante.
Más de 137 monedas, liquidadas en USD
Acepte más de 137 monedas de clientes de todo el mundo y reciba cada depósito en USD, directamente en su cuenta bancaria de EE. UU.
Fondos al siguiente día hábil y conciliación
Los lotes se cierran cada noche y los depósitos llegan el siguiente día hábil, según los horarios de corte y la elegibilidad, con informes por depósito en un solo panel de RapidCents.
Preguntas frecuentes
¿Cuál es la diferencia entre el webhook y la redirección?
La redirección le dice que el cliente regresó. El webhook le dice qué pasó con el pago. Un cliente que cierra la pestaña nunca es redirigido, y el pago aun así se realizó, por lo que el estado del pedido debe depender del webhook.
¿Cómo reintento con seguridad después de un tiempo de espera agotado?
Envíe la misma clave de idempotencia. La solicitud repetida devuelve el resultado original en lugar de crear un segundo cobro, de modo que el cliente puede reintentar sin saber si el primer intento llegó al servidor.
¿Tengo que manejar 3-D Secure por mi cuenta?
Con la página de pago alojada, el desafío se maneja en la página de RapidCents. Con una integración integrada o por API, su aplicación maneja el evento de desafío que emite el componente. En ambos casos, las reglas que deciden cuándo se ejecuta la autenticación se configuran, no se programan.
¿Hay un compromiso de disponibilidad?
La API de la pasarela tiene un SLA de disponibilidad del 99.9%. Aplica específicamente a la API de la pasarela y no a todas las superficies.
¿Puedo probar rechazos?
Sí. El entorno de pruebas ofrece números de tarjeta de prueba, rechazos simulados y eventos de liquidación, con resultados vinculados de forma determinista a la tarjeta de prueba, que es la única manera confiable de ejercitar la lógica de reintentos antes de que se enfrente a una tarjeta real.
¿Qué pasa cuando cambia la versión de la API?
Los puntos de enlace tienen control de versiones, por lo que una integración existente conserva su comportamiento. Actualizar es un cambio que usted hace deliberadamente. Tenga en cuenta también que las comisiones, los tiempos de financiamiento y los resultados de la evaluación de riesgos del entorno de pruebas son ilustrativos: los valores reales provienen de su cuenta.
¿La autorización y la captura deben ser llamadas separadas?
Solo si envía la mercancía después de cobrar. Autorizar al momento del pedido y capturar cuando sale la mercancía retiene los fondos sin cobrarlos por un pedido aún no cumplido; una venta cobrada en el acto es más sencilla como un solo paso combinado, sin nada que conciliar entre dos llamadas.
¿Se requiere un SDK o un framework específico?
No. La API es REST simple sobre HTTPS y no necesita framework, entorno de ejecución ni SDK, por lo que la integración se puede escribir en el lenguaje que su producto ya utiliza. El único componente de navegador que debe planificar es Rapid.js, que aloja los campos de tarjeta y mantiene los datos de tarjeta fuera de sus servidores.
¿Qué podemos ver una vez que la integración está en producción?
Tráfico en vivo, motivos de rechazo y liquidación, todo en el panel. Vigilarlos desde el lanzamiento significa que la primera anomalía la encuentra su equipo y no la reporta un cliente, y los motivos de rechazo muestran si la lógica de reintentos separa los rechazos temporales de los definitivos.
Dé el siguiente paso
Hable con un especialista de RapidCents
El Análisis de comisiones de RapidCents lee un estado de cuenta de procesamiento y muestra el intercambio por separado del margen. Cargue un estado de cuenta para obtener un desglose inmediato, o abra una cuenta de comerciante y comience a aceptar pagos en una sola cuenta.
- Sin compromiso
- Especialistas en pagos, no un centro de llamadas
- Carga segura del estado de cuenta
