¿Tenéis código de ejemplo en mi lenguaje de programación?

Publicado el · Actualizado el

¿Tenéis código de ejemplo?

Sí. El API es un servicio HTTP estándar: cualquier lenguaje que pueda enviar una petición POST con JSON y autenticación HTTP Basic sirve. No hay que instalar ningún SDK.

Dos cosas que se repiten en todos los lenguajes:

  • Autenticación: la API key es el usuario y la contraseña va en blanco.
  • Respuesta: el SEPA XML llega en Base64 en el campo file; solo tienes que decodificarlo.

La referencia del API también genera fragmentos listos para copiar en varios lenguajes (curl, Python, Node.js, PHP, Ruby, etc.).

Ejemplo en Python

import base64
import requests

r = requests.post(
    "https://api.conversorsepa.es/api/v2/sdd",
    auth=("TU_API_KEY", ""),
    json={
        "name": "Mi Empresa SL",
        "iban": "ES9121000418450200051332",
        "sepa_identifier": "ES97000B12345678",
        "debits": [{
            "name": "Juan Pérez",
            "iban": "ES7921000813610123456789",
            "amount": 2599,  # en céntimos
            "date": "2026-12-05",
            "description": "Cuota diciembre",
            "reference": "FAC-2026-120",
            "mandate_reference": "MANDATO-000123",
            "mandate_signature": "2026-01-15",
        }],
    },
)
if r.status_code != 201:
    raise SystemExit(r.json())
with open("adeudos.xml", "wb") as f:
    f.write(base64.b64decode(r.json()["file"]))

Ejemplo en Node.js (18 o superior)

const auth = Buffer.from("TU_API_KEY:").toString("base64");
const res = await fetch("https://api.conversorsepa.es/api/v2/sct", {
  method: "POST",
  headers: { "Authorization": `Basic ${auth}`, "Content-Type": "application/json" },
  body: JSON.stringify({
    name: "Mi Empresa SL",
    iban: "ES9121000418450200051332",
    payments: [{
      name: "Suministros García SL",
      iban: "ES7921000813610123456789",
      amount: 125000, // en céntimos
      date: "2026-12-05",
      description: "Factura F-2026-311",
      reference: "PAG-311",
    }],
  }),
});
const data = await res.json();
if (res.status !== 201) throw new Error(JSON.stringify(data));
const xml = Buffer.from(data.file, "base64").toString("utf8");

Conclusión

Adapta cualquiera de estos ejemplos a tu lenguaje: basta con una petición POST, autenticación Basic y decodificar el Base64.


Preguntas frecuentes

¿Tengo que instalar alguna librería?
No. Sirve cualquier cliente HTTP que envíe JSON con autenticación Basic: requests en Python, fetch en Node.js, cURL o Guzzle en PHP, Net::HTTP en Ruby.
¿Cómo obtengo el fichero XML?
La respuesta trae el fichero codificado en Base64 en el campo file. Decodifícalo y guárdalo con extensión .xml antes de subirlo a tu banco.
¿Compatible con Lambda/Cloud Run?
Sí. El API es un endpoint HTTP estándar y no requiere ninguna infraestructura especial.

Consulta la documentación del API

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

Artículos relacionados