¿Dispone el Conversor SEPA de un API?

Publicado el · Actualizado el

¿Dispone el Conversor SEPA de un API?

Sí. El API de ConversorSEPA permite que tu ERP, tu plataforma SaaS o tu aplicación interna generen ficheros SEPA XML sin pasar por la web.

En resumen

  • JSON de entrada y de salida.
  • Autenticación HTTP Basic: tu API key es el usuario y la contraseña se deja en blanco. La clave está en tu cuenta, en el menú API.
  • Endpoints: POST /api/v2/sct (transferencias SEPA) y POST /api/v2/sdd (adeudos SEPA CORE o B2B). El API también valida IBAN (POST /api/v2/bank_accounts) y genera mandatos en PDF (/api/v2/mandates).
  • Respuesta: el fichero SEPA XML codificado en Base64, con el número de operaciones y el importe total.
  • Necesitas una suscripción activa o en periodo de prueba; si no, el API responde 401.
  • Presentación en /api; referencia completa de campos en conversorsepa.readme.io.

Ejemplo: una remesa de adeudos

curl -X POST https://api.conversorsepa.es/api/v2/sdd \
  -u "TU_API_KEY:" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Mi Empresa SL",
    "iban": "ES9121000418450200051332",
    "sepa_identifier": "ES97000B12345678",
    "scheme": "CORE",
    "debits": [{
      "name": "Juan Pérez",
      "iban": "ES7921000813610123456789",
      "amount": 2599,
      "date": "2026-12-05",
      "description": "Cuota diciembre",
      "reference": "FAC-2026-120",
      "mandate_reference": "MANDATO-000123",
      "mandate_signature": "2026-01-15"
    }]
  }'

Los importes van en céntimos y como número entero (2599 = 25,99 €) y las fechas en formato AAAA-MM-DD. Para una transferencia, envía la misma estructura a /api/v2/sct con un array payments en lugar de debits (sin los campos del mandato).

La respuesta (HTTP 201) trae el fichero en el campo file, en Base64:

{
  "id": 700,
  "format": "SDD",
  "file": "PD94bWwgdmVyc2lvbj0iMS4wIiBlbmNvZGluZz0iVVRGLTgiPz4K...",
  "operations": 1,
  "amount": 2599,
  "name": "Mi Empresa SL",
  "sepa_identifier": "ES97000B12345678",
  "created_at": 1764892800
}

Decodifica file y tendrás el pain.008 (o el pain.001 si es una transferencia) listo para subir a tu banco.

¿Cuándo te interesa?

  • Generación recurrente y automatizada (facturación mensual, nóminas).
  • Integración con tu ERP o CRM.
  • Plataformas SaaS que cobran a sus propios clientes.
  • Procesos donde las operaciones ya están en otro sistema.

Conclusión

Copia tu API key desde tu cuenta, revisa la página del API y prueba una primera llamada con un solo adeudo o una sola transferencia.


Preguntas frecuentes

¿Cómo me autentico?
Con autenticación HTTP Basic: tu API key es el usuario y la contraseña se deja en blanco. La clave está en tu cuenta, en el menú API, donde también puedes regenerarla.
¿Qué ficheros genera el API?
Transferencias SEPA (pain.001) con POST /api/v2/sct y adeudos SEPA CORE o B2B (pain.008) con POST /api/v2/sdd. El API también valida IBAN y genera mandatos SEPA en PDF.
¿Hay SDK oficial?
No, y no hace falta: basta con un cliente HTTP que envíe JSON con autenticación Basic. La referencia del API en conversorsepa.readme.io genera ejemplos en varios lenguajes.

Consulta la documentación del API

Probar ahora →
¿Te ha sido útil este artículo?

Artículos relacionados