¿Puedo ver peticiones y respuestas en distintos casos?
Sí. La referencia del API incluye un ejemplo de petición y respuesta para cada endpoint. Estos son los casos más habituales.
Transferencia SEPA (SCT)
curl -X POST https://api.conversorsepa.es/api/v2/sct \
-u "TU_API_KEY:" \
-H "Content-Type: application/json" \
-d '{
"name": "Mi Empresa SL",
"iban": "ES9121000418450200051332",
"payments": [{
"name": "Suministros García SL",
"iban": "ES7921000813610123456789",
"amount": 125000,
"date": "2026-12-05",
"description": "Factura F-2026-311",
"reference": "PAG-311"
}]
}'
amount va en céntimos (125000 = 1.250,00 €). Campo opcional: reason con salary (nóminas, código SALA) o pension (código PENS); si no lo envías, el fichero lleva el código OTHR.
Adeudo SEPA CORE o B2B (SDD)
Misma estructura en /api/v2/sdd, con sepa_identifier (tu identificador de acreedor) en el nivel superior y un array debits. Cada adeudo añade mandate_reference (referencia del mandato) y mandate_signature (fecha de firma del mandato, AAAA-MM-DD, que no puede ser futura). El campo scheme vale CORE por defecto; envía B2B para un adeudo entre empresas o FINANCED para una remesa financiada (anticipo de la Norma 58, solo en España).
El fichero generado lleva siempre el tipo de secuencia RCUR, también en el primer cobro de un mandato: las normas del EPC lo permiten desde noviembre de 2016.
Varias fechas en la misma llamada
Si tus operaciones tienen fechas distintas, el API las agrupa por fecha: un solo fichero, con un bloque de pago (PmtInf) por cada fecha.
Respuesta correcta (201)
{
"id": 701,
"format": "SCT",
"file": "PD94bWwgdmVyc2lvbj0iMS4wIiBlbmNvZGluZz0iVVRGLTgiPz4K...",
"operations": 1,
"amount": 125000,
"name": "Mi Empresa SL",
"sepa_identifier": null,
"created_at": 1764892800
}
file contiene el XML codificado en Base64 y created_at es una marca de tiempo Unix.
Errores
- 401: API key ausente o incorrecta (se rechaza la autenticación HTTP Basic), o cuenta sin suscripción activa. En este último caso, el cuerpo es
{"error": "..."}. - 422: datos no válidos. El cuerpo incluye
errors, con un mensaje por cada problema detectado (IBAN inválido, concepto vacío, fecha de mandato futura, etc.).
{
"errors": ["El adeudo para Juan Pérez tiene un IBAN inválido"]
}
Conclusión
Parte del ejemplo más parecido a tu caso, pruébalo con una sola operación y después envía la remesa completa.