Transaction Status
| ID | Status | Definition | Applies To |
|---|---|---|---|
| 1 | Initializing | Only used for when transaction is first being created and shouldn't stay in this status for more than a millisecond | TX |
| 2 | Pending | Waiting to be acted upon | TX,D,P,T,A |
| 3 | Active | Generally only used for Event Subscriptions when they are actively sending requests to endpoints | TX,A |
| 4 | Completed | Transaction, Document, Participant, Task, or Action has been successfully completed | TX,D,P,T,A |
| 5 | UNUSED | Status code not currently in use | - |
| 6 | Email Sent | Only applies to Participants noting that an email has been sent. This is directly related to "Pending" status and should be treated the same as well | P |
| 7 | Closed | Closed for further action - done via administrative action | TX,D,P,T,A |
| 8 | Cancelled | Closed for further action - done via participant action | TX,D,P,T |
| 9 | Expired | Closed for further action - done via passing expiration date on transaction | TX,D,P,T,A |
| 10 | Voided | Closed for further action - done via administrative action. For transactions, this can only be applied to a completed transaction. Documents can be voided via API call | TX,D |
Legend
| Code | Entity Type | Description |
|---|---|---|
| TX | Transactions | Primary workflow containers that manage the overall signing process |
| D | Documents | PDF or other file types that require signatures or actions |
| P | Participants | Users who need to take actions within the Transaction |
| T | Tasks | Individual action items assigned to participants (i.e. signature, approval, delivery, etc.) |
| A | Actions/Events | Specific operations or event subscriptions within the system |
Note: Some status codes may apply to multiple entity types. Refer to the "Applies To" column for specific applicability.
Error Codes
s00 - Expected information not provided.s01 - no signature ID provided on the call to SignADoc.s02 - can't create required object - (Server.CreateObject failed).s03 - document status is "signature operation pending".s04 - document is closed for signing (status >= 4).s05 - document status can't be determined.s06 - signature status is "signature operation pending".s07 - signature is closed for signing (status >= 4).s08 - signature status can't be determined.s09 - an error occurred during the signing operation.s10 - the signing function returned FAILURE or ERROR - ErrMsg returned.s11 - database error.s12 - can't determine next step.s13 - can't read file.s14 - invalid parameters used in this request.s15 - image file cannot be saved.s21 - The document is not yet ready for signature.s22 - The document is currently being signed by another party. Please try again in a minute.s23 - The document has already been signed for this signer. It may not be re-signed.s24 - This transaction has been closed. The document may not be signed.s25 - This transaction has been cancelled. The document may not be signed.s26 - This transaction has expired. The document may not be signed.s27 - This signature request has an unknown status - the document may not be signed.s28 - The signature image submitted was blank or empty.s29 - Form data could not be saved.s30 - No client (signer) digital certificate was available for signing.s31 - Client digital certificate use (signing) was cancelled by the user.s32 - User session timeout.s33 - User authentication timeout/login error.s34 - The Instance ID of this application could not be determined.
Transaction Code Samples
Code samples for transaction-related operations in AlphaTrust e-Sign.