You are here: Mandates > E-Mandate Options > Uploading a Contract

Uploading a Contract

To upload a contract, use the Upload Contract request.

Contracts must be saved in PDF and we recommend that the file size does not exceed 1 MB.
API Reference Upload Contract
Usage The contract must be a PDF file (application/pdf)
Method POST

The following optional argument may be included in your request:

fileName If not provided the name of the uploaded file is used.


Contracts can be either once-off or recurring: Once-Off (OOFF) contracts are just used once in a single signing operation.

Recurring (RCUR) contracts can be re-used in multiple signing operations; this is useful where your business use a standard contract and you want to offer all your customers the same PDF contract document.

Additional optional arguments may be provided (see the API reference for full details)


A successful request will return a 200 Created response code

If you do not see a 200, see the HTTP Response Codes section of the API Reference to assist you to troubleshoot the issue.

The following are returned:

uri A resolvable path to the contract
id A resource identifier that uniquely identifies the contract in Nuapay

Once you have retrieved your contract identifier you can use it in your Prepare E-Mandate request in your chosen integration approach: