FirmARDigital

Documentación para desarrolladores

Primeros pasos

Sandbox

Probá el ciclo completo de tu integración con claves de prueba antes de conectar usuarios o documentos reales.

Qué podés probar

Autenticación y scopes

Creación simulada de firmantes

Creación de sesiones y polling

Manejo de respuestas y errores

Integración de webhooks

Crear una sesión de prueba

La respuesta devuelve una URL simulada y un `documentId` con prefijo `sandbox_document_`.

bashFirmARDigital API
curl --request POST https://www.firmardigital.com/api/v1/signing-sessions \
  --header "Authorization: Bearer fmr_test_TU_CLAVE" \
  --header "Idempotency-Key: demo-001" \
  --form "file=@contrato.pdf;type=application/pdf" \
  --form 'data={"externalId":"cliente-4821","title":"Demo","recipient":{"name":"Test User","email":"test@example.com"}}'
201

Respuesta simulada

jsonFirmARDigital API
{
  "success": true,
  "data": {
    "documentId": "sandbox_document_5c2e…",
    "sessionUrl": "http://localhost:3000/sandbox/signing-sessions/sandbox_session_…",
    "expiresAt": "2026-08-01T18:00:00.000Z",
    "reused": false,
    "sandbox": true
  }
}

Reconciliación en sandbox

  1. Creá el firmante y conservá su ID `sandbox_signer_*`.
  2. Creá la sesión, conservá su `documentId` `sandbox_document_*`.
  3. Consultá el estado: la simulación responde `SIGNED` para que puedas probar tu flujo final.
  4. No intentes descargar el PDF: sandbox responde `404` porque no genera archivos persistentes.