Waarom een API specifiek voor elektronische handtekeningen?
Het integreren van elektronische handtekeningen in uw product is niet triviaal. U hebt garanties nodig over wettelijke naleving (eIDAS), technische betrouwbaarheid (webhooks die echt binnenkomen) en controle over uw gegevens: Certyneo is een onderneming naar Frans recht, en uw gegevens blijven in de Europese Unie. De Certyneo API dekt alle drie.
De API is ontworpen door en voor ontwikkelaars en volgt de REST-conventies: versie in de URL (/api/v1), paginering met page en limit, JSON-fouten met een machineleesbare code, OpenAPI-specificatie om uw clients te genereren. Geen SOAP, geen XML, geen verrassingen.
Welk eIDAS-handtekeningniveau kiest u via de API?
De eIDAS-verordening definieert drie niveaus van handtekening: eenvoudig (SES), geavanceerd (AES) en gekwalificeerd (QES). Met de Certyneo-API kiest u het niveau van elke envelop via het veld signatureLevel: SIMPLE (standaard), ADVANCED of QUALIFIED. De eenvoudige handtekening dekt de meeste gangbare handelscontracten; de QES is bedoeld voor wanneer een wet of een ontvanger gelijkwaardigheid met de handgeschreven handtekening eist.
Technisch gezien activeert het geavanceerde niveau automatisch de sms-OTP en vraagt het om een telefoonnummer voor elke ondertekenaar. De audittrail krijgt een tijdstempel volgens de norm RFC 3161. De QES berust op een gekwalificeerd certificaat, uitgegeven door een gekwalificeerde verlener van vertrouwensdiensten in de EU. Alles wordt via de API aangestuurd.
Welke integratiearchitectuur kiest u?
Het meest voorkomende integratiepatroon volgt deze flow:
- Uw backend uploadt de pdf (POST /api/v1/documents), maakt de envelop als concept aan (POST /api/v1/envelopes) en verstuurt hem daarna (POST /api/v1/envelopes/:id/send).
- De ondertekenaar ontvangt de uitnodiging per e-mail, of ondertekent rechtstreeks in uw interface dankzij de ingebouwde ondertekening via iframe (POST /api/v1/envelopes/:id/embed-url, vanaf het Standard-plan).
- Zodra de handtekening is voltooid, roept Certyneo uw webhook aan met het envelope.completed event.
- U werkt uw database bij en stelt de gebruiker op de hoogte (e-mail, in-app, enz.).
Hoe test u de API zonder te betalen?
sk_test_-sleutels zijn beschikbaar op alle plannen, ook Gratis, en testenveloppen tellen niet mee voor uw maandelijkse quotum. Op het Gratis-plan kunnen ze alleen naar uw eigen e-mailadres worden gestuurd en zijn ze beperkt tot 20 verzoeken per uur; de plannen die toegang geven tot de productie-API gaan van 200 tot 1000 verzoeken per uur. Testgegevens worden na 30 dagen gewist. De eerste testsleutel van een gratis account geeft bovendien een dag lang toegang tot het Standaard-plan.
Kunt u ondertekening integreren zonder code te schrijven?
Alles wat deze API doet, kan ook zonder code worden beheerd via een stroom: een omslag maken, verzenden, reageren op een handtekening, de verzegelde PDF en audittrail ophalen. Dezelfde basis, met een visuele ontwerper in plaats van een HTTP-client. Zie de Power Automate- en Microsoft 365-integratie.
Hoe migreert u een DocuSign- of Yousign-integratie?
Als u al een DocuSign- of Yousign-integratie voor elektronische handtekeningen heeft, is de terminologie vergelijkbaar: envelopes → envelopes, recipients → recipients, statuswebhooks → webhooks. De migratiehandleiding van DocuSign en Yousign naar Certyneo beschrijft de stappen, van het exporteren van sjablonen tot het overzetten van de webhooks.
Migreert u van Adobe Acrobat Sign (voorheen EchoSign, daarna Adobe Sign)? De mapping is even eenvoudig — agreements → envelopes, participants → recipients, webhooks → webhooks. Certyneo en Adobe Acrobat Sign vergelijken →
Prijs van een API voor elektronische handtekeningen: waar een abonnement kopen?
Geen offerte of inkooporder nodig om een abonnement op de ondertekenings-API af te sluiten: de testsleutels zijn gratis, de API-sleutel wordt in het dashboard gegenereerd en toegang tot de productie-REST-API is inbegrepen vanaf het Standard-plan op 19 €/maand — webhooks inbegrepen, zonder kosten per eenvoudige handtekening.
| Plan | Maandprijs excl. btw | Enveloppen per maand | Verzoeken per minuut per sleutel | Webhook-endpoints | Inbegrepen gekwalificeerde handtekeningen per maand |
|---|---|---|---|---|---|
| Standaard | € 19 | 100 | 60 | 5 | 0 |
| Bedrijf | € 39 | 300 | 120 | 15 | 1 |
| Business Pro | € 99 | 1.000 | 300 | 50 | 3 |
De gekwalificeerde handtekening (QES) wordt per handeling gefactureerd en bij verzending betaald: 9,90 € per handtekening met een abonnement, afgeschreven van de opgeslagen kaart zodra de in Business en Business Pro inbegrepen QES op zijn, en 14,90 € zonder abonnement.
Voor grote volumes of behoefte aan contractuele verplichting (SLA, toegewezen DPA, jaarlijkse facturering), wordt het Enterprise-plan afgesloten met het verkoopteam. In alle gevallen zijn de prijzen openbaar — vergelijk ze voordat u zich verbindt.
De details van elk abonnement staan op de pagina tarieven van Certyneo; hoe deze prijzen zich verhouden tot andere aanbieders, leest u in de prijsvergelijking voor elektronische handtekeningen.