Initiate Sign Request
Last updated
Was this helpful?
Last updated
Was this helpful?
This endpoint allows RP to initiate a signing session by sending the raw PDF document. The service processes the document to set up a signing transaction and returns a unique sign request identifier along with a signing URL to redirect users to in order for them to perform the signing.
Each signing session has a validity of 30 mins. RPs should only initiate a request when the application is ready to redirect the user to the Sign portal to perform the signing.
All signing sessions must be initiated via the and not through providing any redirect links directly to the user.
POST
/sign-requests
Content-Type
application/octet-stream
Authorization
<token>
RPs should sign the signature parameter into a JWT token as authorization token.
Token Type: Standard JWT ()
Payload:
x
& y
: Coordinates for placing the signature. The values should be ≥ 0 and <1, with a maximum precision of four decimal places. See detailed explaination in How to set signing coordinates
page
: The page number for placing the signature. Starting from 1.
doc_name
: The name of the document. This will be shown to the user.
client_id
: Your application's registered client ID.
jti
: Standard JWT ID, a unique identifier for the JWT, must be a UUID.
iat
& exp
: Standard Issued At / Expiration timestamp of JWT. Must issued within 2 minutes.
Example:
Raw binary PDF content
PDF must be less than 10 MB in size.
PDF must be unencrypted.
If the PDF contains existing signature(s):
These signatures should fulfil the requirements of a PAdES signature (minimally B-T). Note: Signatures created with Sign will automatically fulfil these requirements
These signatures should not overlap with the x-y coordinates given.
Sample request
When starting a sign request, define the signature position using the x
and y
parameters in the JWT payload. These coordinates are percentage-based and relative to the PDF's dimensions, starting from the bottom left corner.
y: Vertical position (0 to 1), where 0 is the bottom and 1 is the top.
x: Horizontal position (0 to 1), where 0 is the left and 1 is the right.
We will not accept coordinates where a signature cannot be placed due to being outside the page boundaries. The signature size is fixed at 60x225 points, regardless of the PDF size.
x = 0, y = 0
The bottom-left corner of the signature is positioned at the bottom-left corner of the document.
x = 0.5, y = 0.5
The bottom-left corner of the signature is positioned in the center of the document.
x = 1, y = 1
Error due to signature will be out of page area
x = 0.00001, y = 0.00001
Error due to max friction is 4
The PDF document is held temporarily during the signing process and purged when no longer needed.
You can use the free tool to verify if your token is signed properly.
The signing URL will bring the signer to the where they will perform the signing.
exchange_code
should be treated as a secret as it will be used to . Please do not share the code or put in your application logs.