Skip to main content

LaaS - Contract Signature


Provided by Sofiane ZIANE
Last update 28.01.2026
Status Live
Version 1.0.1
Category Product
API Product(s) orchestrator-contract-signature-v1

Country
User profile
Tags
LaaS
Signature

Test cases

The test cases provided through the sandbox cover the following scenarios.

Status

There are 2 levels of status on the signature entity: one for the envelop and one for each signatory. Here are their meanings and relationships.

Please note that the status of the associated Proposal is never changed with any update on the Signature status.

Envelop

StatusMeaningConsequences
SIGNATURE_ONGOINGThe signature process is in progress 
SIGNATURE_COMPLETEThe signature process ended successullyThe customer journey can proceed normally
SIGNATURE_EXPIREDThe envelop has expired (after e.g. 120 days) before all signatories have signedThe customer journey is stopped. If needed, the process has to restart from the creation of a quotation.
SIGNATURE_CANCELLEDThe BPLS team has cancelled the envelopThe customer journey is stopped. If needed, the process has to restart from the creation of a quotation.
SIGNATURE_REFUSEDAt least one signatory has actively refused to signThe customer journey is stopped. If needed, the process has to restart from the creation of a quotation.
OTHER_FAILUREProvisionary case for other unpredictable errorsThe customer journey is stopped. If needed, the process has to restart from the creation of a quotation.

Signatory

StatusMeaningConsequences
SIGNATURE_PENDINGWaiting for the signatory to sign 
SIGNATURE_COMPLETEThe signatory has signed the contractThe signatory has signed. The envelop remains in status SIGNATURE_ONGOING until all signatories have signed.
SIGNATORY_DELIVERY_FAILEDThe signature request mail could not be deliveredThe envelop remains in status SIGNATURE_ONGOING until it expires. However the customer journey is stopped. If needed, the process has to restart from the creation of a quotation.
IDENTITY_CHECK_FAILEDThe signatory failed to validate their identity (after 3 trials)The envelop remains in status SIGNATURE_ONGOING until it expires. However the customer journey is stopped. If needed, the process has to restart from the creation of a quotation.
SIGNATURE_REFUSEDThe signatory actively refused to signThe envelop itself turns its status to SIGNATURE_REFUSED

Errors

Functional errors returned by the API

Create operation

  • SIGNATORIES_UNDEFINED: the signatories have not yet been set on the contract
  • BANK_INFORMATION_UNDEFINED: the bank account information has not been set on the contract

SLA and availability

Standard SLA

Limited availability (except planned maintenance): 7:30 - 22:00 (CET / CEST) on Monday to Sunday