Signatures

myID.be® provides a digital signature service with an HTTP-based API. The digital signature service can be used to sign data. See Signature types for more information on the data types that can be signed.

The following sequence diagram shows a typical session to sign a document with an actor (the person signing), an organisation named Contoso requesting a signature, and the myID.be® signature service at sign.myid.be.

sequenceDiagram
    participant 'Actor as Actor
    'Actor->>+Contoso: Start the signature process
    Contoso->>+sign.myid.be: /api/sign
    sign.myid.be-->>-Contoso: RespID + Unique sign url
    Contoso-->>-'Actor: Redirect to <Unique sign url>
    'Actor->>+sign.myid.be: Navigate to <Unique sign url>
    Note over 'Actor, sign.myid.be: The actor uses their myID.be® app to sign the data.
    sign.myid.be-->>-'Actor: Redirect to <Organisation ReturnUrl>
    'Actor->>+Contoso: Navigate to <Organisation ReturnUrl>
    Contoso->>+sign.myid.be: /api/retrievePending
    sign.myid.be-->>-Contoso: Signature result
    Contoso-->>-'Actor: User feedback

Note that the session is not created until the user is online and ready to sign.