Primeros pasos

Quickstart

Un flujo mínimo para registrar un firmante, crear una sesión y consultar su estado desde tu backend.

Registrá al firmante

Guardá el id devuelto para asociarlo con tu sistema.

bashFirmARDigital API

curl --request POST https://www.firmardigital.com/api/v1/registered-signers \
  --header "Authorization: Bearer fmr_test_TU_CLAVE" \
  --header "Content-Type: application/json" \
  --data '{"externalId":"cliente-4821","fullName":"María González","email":"maria@ejemplo.com"}'

201

Respuesta de sandbox

jsonFirmARDigital API

{
  "success": true,
  "data": {
    "id": "sandbox_signer_0b11…",
    "externalId": "cliente-4821",
    "status": "ENROLLED",
    "enrollmentUrl": null,
    "expiresAt": null,
    "alreadyEnrolled": false,
    "sandbox": true
  }
}

Creá la sesión

La API devuelve una URL para que el firmante complete el proceso.

bashFirmARDigital API

curl --request POST https://www.firmardigital.com/api/v1/signing-sessions \
  --header "Authorization: Bearer fmr_test_TU_CLAVE" \
  --header "Idempotency-Key: solicitud-4821" \
  --form "file=@acuerdo.pdf;type=application/pdf" \
  --form 'data={"externalId":"cliente-4821","title":"Acuerdo comercial","recipient":{"name":"María González","email":"maria@ejemplo.com"}}'

201

Respuesta de sandbox

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
  }
}

Consultá el estado

Usá polling o webhooks para detectar cuándo finaliza.

bashFirmARDigital API

curl https://www.firmardigital.com/api/v1/signing-sessions/DOCUMENT_ID \
  --header "Authorization: Bearer fmr_test_TU_CLAVE"