1. Contrato digital
API Kambia
  • Introducción
    • API Kambia
    • Credenciales
    • Autenticación
    • Verificación
      POST
  • Servicios
    • Catálogo de códigos
    • Contrato digital
      • Notificaciones
      • Plantilla digital
      • Create signature
        POST
    • Payin
      • Notificaciones
      • Create payin
    • Payout
      • Notificaciones
      • Create payout
    • Débito automático
      • Affiliation
      • Charge
  1. Contrato digital

Create signature

Desarrollando
POST
/v1/signature/{{merchant_id}}
Envío de contrato digital mediante plantilla
Antes de enviar una solicitud de firma, el cliente debe hacer llegar a Kambia la(s) plantilla(s) de contrato (documento Word o Docs) para asignar claves únicas al documento, firmantes y campos dinámicos (si aplica) para su uso en la solicitud.
Como respuesta, Kambia entregará por cada plantilla:
El valor de name para identificar al documento
El valor de key para identificar a cada firmante
El listado de claves del objeto data que contiene los campos dinámicos
Modo demo (notificaciones automáticas)
Para facilitar las pruebas de integración del webhook, la API detecta automáticamente ciertos prefijos en el title y envía la notificación correspondiente al signature_webhook del merchant ~500 ms después de crear el contrato digital.
Prefijos reservados
title empieza porEstado enviado en el webhook
DEMO_CREATEDCREATED
DEMO_BOUNCEDBOUNCED
DEMO_REJECTEDREJECTED
DEMO_CANCELEDCANCELED
DEMO_SIGNEDSIGNED
El sufijo es libre: DEMO_SIGNED_contrato_001, DEMO_REJECTED_test, etc.
Comportamiento
La respuesta del create es idéntica a la de un contrato digital normal.
El webhook tiene el mismo formato y firma (x-kambia-signature) que una notificación real.
En SIGNED demo se incluye document_url: "https://demo.kambia.app" (enlace de prueba).
En BOUNCED, REJECTED y CANCELED se incluye reason con un mensaje representativo.

Solicitud

Parámetros del Body application/jsonRequerido

Ejemplos

Respuestas

🟢201Created
application/json
Bodyapplication/json

Respuesta Ejemplo de Respuesta
{
    "status_code": 201,
    "message": "Signature envelope created successfully",
    "data": {
        "signature_id": "894f0895-bc99-452b-a330-373aac9f01dd",
        "status": "PENDIENTE",
        "title": "Contrato de préstamo ABC-123",
        "routing": "parallel",
        "sender": {
            "name": "Kambia SAC",
            "email": "contacto@kambia.app"
        },
        "documents": [
            {
                "key": "document_0",
                "title": "Plantilla de préstamo individual"
            }
        ],
        "recipients": [
            {
                "key": "signer_1",
                "name": "Jair Loayza",
                "email": "jair@kambia.app",
                "status": "pending"
            }
        ],
        "created_at": "2026-02-05T22:03:39.467Z"
    }
}
Modificado en 2026-08-26 01:13:20
Anterior
Plantilla digital
Siguiente
Notificaciones
Built with