Signing Order

In the case of a multi-signer transaction, Proof supports setting an order your signers should complete their documents in.

A signing order is set via the API by setting a value for the order parameter on the signer object. order must be an integer >= 1.

Notifications to signers

Signers get notified via our standard email/SMS once it is their turn to sign. For example, in a two signer example where Signer 1 has order : 1 and Signer 2 has order : 2, Signer 2 would not be notified until Signer1 has completed their designations/placed their signature on the documents.

If a signer logs into their account and attempts to access a transaction before it is their turn to sign they will be able to view the document but not place any signatures or join a notary meeting.

Once a signer has finished signing, they will be able to view the document but not download it until the remaining signers have completed their requirements.

Scenarios

Scenario A: Specified order for all signers

All signers must sign in a specified order (1, 2, 3, 4 etc.): Peter must sign 1st, Tony must sign 2nd, Steve must sign 3rd, Thor must sign 4th.

{  
    "document": "https://www.w3.org/WAI/ER/tests/xhtml/testfiles/resources/pdf/dummy.pdf",  
    "signers": [  
        {  
            "email": "[email protected]",  
            "first_name": "Peter",  
            "last_name": "Parker",  
            "order": 1  
        },  
        {  
            "email": "[email protected]",  
            "first_name": "Tony",  
            "last_name": "Stark",  
            "order": 2  
        },  
        {  
            "email": "[email protected]",  
            "first_name": "Steve",  
            "last_name": "Rogers",  
            "order": 3  
        },  
        {  
            "email": "[email protected]",  
            "first_name": "Thor",  
            "last_name": "Odinson",  
            "order": 4  
        }  
    ]  
}

Scenario B: Some signers can sign in any order, others must sign after.

Peter (1) and Tony (1) can sign in any order. Steve (2) must sign last.

{  
    "document": "https://www.w3.org/WAI/ER/tests/xhtml/testfiles/resources/pdf/dummy.pdf",  
    "signers": [  
        {  
            "email": "[email protected]",  
            "first_name": "Peter",  
            "last_name": "Parker",  
            "order": 1  
        },  
        {  
            "email": "[email protected]",  
            "first_name": "Tony",  
            "last_name": "Stark",  
            "order": 1  
        },  
        {  
            "email": "[email protected]",  
            "first_name": "Steve",  
            "last_name": "Rogers",  
            "order": 2  
        }  
    ]  
}

Scenario C: Set first and last signers, with any order for other signers

Peter must sign first (1). Tony (2) and Steve (2) can sign in any order after Peter signs. Thor must sign last (3).

{  
    "document": "https://www.w3.org/WAI/ER/tests/xhtml/testfiles/resources/pdf/dummy.pdf",  
    "signers": [  
        {  
            "email": "[email protected]",  
            "first_name": "Peter",  
            "last_name": "Parker",  
            "order": 1  
        },  
        {  
            "email": "[email protected]",  
            "first_name": "Tony",  
            "last_name": "Stark",  
            "order": 2  
        },  
        {  
            "email": "[email protected]",  
            "first_name": "Steve",  
            "last_name": "Rogers",  
            "order": 2  
        },  
        {  
            "email": "[email protected]",  
            "first_name": "Thor",  
            "last_name": "Odinson",  
            "order": 3  
        }  
    ]  
}

Scenario D: No order

If no order is set, all signers can sign in parallel.

{  
    "document": "<https://s3.us-east-2.amazonaws.com/notarize-test-documents/one_page.pdf">,  
    "signers": [  
        {  
            "email": "[email protected]",  
            "first_name": "Peter",  
            "last_name": "Parker",  
        },  
        {  
            "email": "[email protected]",  
            "first_name": "Tony",  
            "last_name": "Stark",  
        },  
        {  
            "email": "[email protected]",  
            "first_name": "Steve",  
            "last_name": "Rogers",  
        },  
        {  
            "email": "[email protected]",  
            "first_name": "Thor",  
            "last_name": "Odinson",  
        }  
    ]  
}

Interaction with concurrent signing feature

Signing order is compatible with concurrent signing (the ability for signers to join the same notary meeting from different devices). If multiple signers have the same order, they will be able to join the session together using concurrent signing. For example, in Scenario C Tony Stark and Steve Rogers would be able to sign together as they both have an order of 2.