Testing

Testing your notarization flow is about more than just creating transactions - it’s about ensuring that Notarize is seamlessly embedded in your customer journey. Follow this guide to learn about your end-to-end testing options with Notarize.

Production

We do NOT support production testing with fake documents in Production, UNLESS you are testing with an in-house notary (IHN). Contact Notarize Support if you’d like to add IHN to your contract.

Fairfax (Test)

To mark a notarization transaction as “Completed”, a notary must apply a seal and mark the transaction as complete. To perform a mock notarization in the Fairfax environment, you have two options: setup an in-house notary (IHN) profile, or build a flow to “mock-complete” your transaction by pinging your webhook URL.

IHN

By setting up an IHN profile on your account, you can have a stakeholder on your team log in as a notary and pick up the call from the signer. They can then apply their seal and complete the transaction officially, allowing you to receive a completion Webhook notification and test downstream functionality as needed. Follow this guide to set up an IHN profile in your Fairfax account.

IHN is an org-level configuration. If you need this feature enabled on your account, contact Customer Success.

Testing Procedure

Running a successful end-to-end test with an IHN can be accomplished in the following manner:

1. In Fairfax, follow the steps for onboarding an IHN to your account. Make sure to reach out to the Notarize team to get your IHN profile approved.
2. Assign one person to act as the notary, and one person to act as the signer. See the linked guides on how to operate the platform from these perspectives.
3. Create your transaction via API. Use our test document if needed.
4. Signer receives email and begins verification steps.
5. Signer enters waiting room and notary picks up call.
6. Notary ends meeting
7. Verify downstream behavior as needed.

Webhook Mock Completion

The following webhook V2 event will be fired to your configured webhook URL when a transaction’s status is updated:

{
  "event": "transaction.completed",
  "data": {
    "transaction_id": "otxxxxxxx",
    "status": null
  }
}

And in V1:

{
  "event": "transaction_status_update",
  "data": {
    "transaction_id": "ot_xxxxxxx",
    "status": "completed"
  }
}

An alternative way to achieve an end-to-end “test” is to set up an automated request flow like such:

1. Create a Transaction
2. Ping your webhook URL with the right webhook event for the given test case.
3. Instead of retrieving a document via our API, retrieve a static “test” document from your systems, or use ours.