Configura tu experiencia
Funcionalidades activas
Refunds
Tokenization
Recurring Payments
País
Tipo de integración
Referencia de la API
Aquí está el detalle de cada endpoint: su ruta, sus parámetros, el cuerpo que espera y lo que devuelve, con ejemplos que se pueden ejecutar. Si lo que buscas es entender un flujo completo en vez de una llamada suelta, eso vive en las Guías.
Dónde estás
La documentación tiene dos partes y conviene saber cuál abrir.
Guías responde cómo hago X: flujos completos, con contexto y decisiones.
Referencia de la API, esta sección, responde qué manda y qué devuelve este endpoint.
Guías responde cómo hago X: flujos completos, con contexto y decisiones.
Referencia de la API, esta sección, responde qué manda y qué devuelve este endpoint.
Por dónde empezar
Tres pasos, y ninguno lleva más de unos minutos.
| Qué hacer | Dónde |
|---|---|
| Crear una credencial y elegir sus permisos | Ambientes y credenciales |
| Canjearla por un token de acceso | Tu primer token |
| Hacer tu primer cobro en sandbox | Tu primer cobro |
Servicios de Akua
Cómo está organizada esta referencia
Los endpoints están agrupados por recurso, en el mismo orden en que aparecen en un ciclo de integración normal: primero las cuentas, después el cobro, después lo que pasa con la plata.
| Grupo | Qué contiene |
|---|---|
| Autenticación | Emitir y revocar tokens |
| Organizaciones y comercios | La jerarquía de cuentas y su información fiscal |
| Instrumentos | Tarjetas y otros medios guardados |
| Pagos y transacciones | Autorizar, capturar, anular, devolver |
| Card present | Puntos de venta, terminales y cobro con la tarjeta delante |
| Links | Cobro por link y onboarding de comercios |
| Contracargos | Disputas, evidencia y ciclo de vida |
| Webhooks | Registro de endpoints y eventos |
| Liquidaciones | Cashouts y conciliación |
Antes de integrar
Cuatro cosas que evitan la mayoría de los problemas
- Idempotencia: cómo reintentar sin cobrar dos veces.
- Errores de la API: la forma del sobre de error y qué hacer con cada uno.
- Por qué la respuesta HTTP no es el resultado: un 201 no significa que el cobro salió.
- Versionado: qué cambios pueden romperte la integración y cuáles no.
Si detectas una diferencia entre la respuesta del servicio y lo documentado en esta página, repórtala a tu contacto de Akua. La documentación se mantiene alineada con el comportamiento real de la API.
¿Te resultó útil?