API pública
Transacciones, checkout hospedado, saldo y retiros mediante contratos documentados.
Para quienes construyen
Una integración clara.De principio a fin.
Empieza por el contrato, preserva la intención y sigue los eventos. La documentación explica el camino entre tu aplicación y Akkro.
Hecha para conectarakkro / integración
POST /v1/transactionsHost: api.akkropay.appx-api-key: <TU_CLAVE_EN_EL_SERVIDOR>X-Idempotency-Key: <CLAVE_DEL_PEDIDO>Content-Type: application/json { "amount": 27900, "paymentMethod": "pix", "customer": { "name": "Ejemplo", "email": "demo@example.com", "document": { "type": "cpf", "number": "<CPF_DEL_CLIENTE>" } }, "items": [{ "title": "Ejemplo", "unitPrice": 27900, "quantity": 1, "tangible": true }]}api.akkropay.appExplorar documentación
Ejemplo de lectura. Consulta el contrato completo antes de integrar. No hay un entorno público de pruebas.
Una solicitud, una identidad.
Cada paso tiene una responsabilidad. Explora el contrato antes de conectar tu aplicación.
Idempotencia
Una clave identifica la intención financiera en los reintentos de creación.
Webhooks
Recibe eventos, valida la firma cuando esté configurada y gestiona la entrega de forma segura.
Las buenas decisiones empiezan con respuestas claras.
Prepara la autenticación, los reintentos y los eventos que conectan tu backend al pago.
Profundiza en la documentación01¿Puedo poner la clave de la API en el navegador?
No. La credencial de la API de pagos debe estar en el backend, fuera del JavaScript público, los repositorios y los logs. Separa la experiencia del comprador del código que autoriza la operación. Si se expone una credencial, sustitúyela y revisa su uso.
Explorar este tema02¿Cómo reintentar sin duplicar el cobro?
Conserva la X-Idempotency-Key para reintentar la misma intención financiera y sigue las reglas del endpoint. Un timeout no demuestra un fallo: consulta el estado antes de iniciar otra intención. Un cobro diferente debe tratarse como una operación nueva.
Explorar este tema03¿Cómo confirma mi sistema un pago de forma segura?
Recibe los webhooks en el backend, valida la firma cuando haya un secreto configurado y procesa los eventos repetidos de forma idempotente. Relaciona el evento con el pedido y consulta la transacción cuando sea necesario. El retorno visual del comprador, por sí solo, no debe liberar el pedido.
Explorar este tema04¿Cómo investigo una venta pendiente o con diferencias?
Localiza la transacción por su referencia, revisa el estado y los registros disponibles y compáralos con el pedido en tu sistema. Consultar la transacción por API complementa los eventos recibidos. No asumas que un pago falló solo porque aún no llegó una notificación.
Explorar este tema05¿Las demostraciones mueven dinero? ¿Hay sandbox?
Las demostraciones usan registros ficticios y no realizan solicitudes financieras. Explican el recorrido, pero no son un entorno de pruebas de la API. La documentación utiliza producción; no hay staging ni sandbox público. Planifica cualquier validación real antes de ejecutarla.
Explorar este temaEl próximo capítulo de tu operación empieza aquí.
Conoce la plataforma Akkro y sigue tus pagos con contexto.