Documentacion tecnica

Cobra con tarjeta desde tu sistema.

Tres formas de integrar, un contrato que se verifica todos los dias contra el API real, y clientes listos para PHP, TypeScript y Python. Todo lo tecnico esta aca y es publico: no hace falta ser cliente para leerlo ni para probarlo.

Ver conectores Empezar a integrar

Si usas una plataforma conocida, no programas nada

Descargas el conector, pegas tu llave y ya cobras con tarjeta.

WooCommerceDescargable OdooEn construccion ShopifyPlanificado PrestaShopPlanificado

MagentoPlanificado SAP Business OneA pedido

ZohoPlanificado QuickBooksPlanificado

SalesforceA pedido

Ver los pasos de instalacion de cada uno →

Las tres formas de cobrar

1Checkout alojadoCreas el pago y rediriges a una pagina de ROKI. Cero trabajo de frontend y ninguna exposicion a datos de tarjeta.

2Componentes embebidosLos campos de tarjeta los dibuja ROKI dentro de un iframe en tu sitio. El cliente no se va de tu pagina.

3Tarjeta guardadaCobras una tarjeta que el cliente ya guardo, sin que este presente. Requiere autorizacion por comercio.

Para agentes de codigo

Si integras con un asistente de programacion, ROKI publica un servidor Model Context Protocol con el mismo contrato que esta documentacion, mas un validador y un sandbox que hace llamadas reales sin ninguna llave tuya:

claude mcp add --transport http roki-connect https://mcp.roki.la/mcp

Tambien estan publicados la especificacion, esta guia en markdown y un indice para agentes.

Lo que mas se rompe

Inicio rápido →...Crear un pago →7.1 Campos obligatorios Campo Tipo Regla amount number Mínimo 0.01. Unidades decimales, no centavos (150.50 = L 150...Webhooks →Son la confirmación autoritativa de un cobro. Sin ellos, una integración depende de que el cliente vuelva al sitio ...Catálogo de errores →HTTP Cuándo Forma 401 Falta Authorization o la llave es inválida {"message": "..."} 404 (aplicación) El pago no exi...