REST API Referentie
Integreer onze gecertificeerde SEPA XML converter en mandaatbeheer rechtstreeks in uw eigen CRM, ERP of administratiesoftware.
Beveiliging & Tokens
De API van SEPA Manager maakt gebruik van Bearer Token authenticatie. U kunt uw persoonlijke API-keys genereren in de Developer-sectie van uw Dashboard. Stuur de API-key mee in de HTTP Headers van elk verzoek.
HTTP Headers:
/v1/xml/convert
Converteer een gestructureerd JSON payload met transacties direct naar een ISO-20022 compliant `pain.008.001.02` XML-bestand. Dit bestand is direct klaar voor aanlevering bij uw bank.
Payload Parameters
Realtime Status updates
Registreer een webhook URL in uw dashboard om realtime updates te ontvangen over de status van uw conversies, storno-rapportages of handmatig ingediende machtigingen.
- ✓
batch.created- Zodra de batch succesvol is geanalyseerd. - ✓
batch.failed- Indien er validatiefouten zijn gevonden. - ✓
mandate.updated- Bij wijzigingen in een getekende machtiging.
curl -X POST https://api.sepamanager.nl/v1/xml/convert \
-H "Authorization: Bearer sm_live_123" \
-H "Content-Type: application/json" \
-d '{
"creditor_id": "NL12ZZZ345678900000",
"batch_name": "FACT-2026-Q2",
"transactions": [
{
"end_to_end_id": "TX-90812",
"iban": "NL99ABNA0123456789",
"bic": "ABNANL2A",
"name": "J. de Vries",
"amount": 149.50,
"description": "Contributie Q2 2026",
"mandate_id": "MND-VRIES-01",
"mandate_date": "2026-01-15",
"sequence_type": "RCUR"
}
]
}'{
"status": "success",
"batch_id": "bat_87fa230b91d4401a",
"xml_url": "https://api.sepamanager.nl/files/bat_87fa230b91d4401a.xml",
"stats": {
"total_transactions": 1,
"total_amount": 149.50,
"currency": "EUR"
}
}