Upload Mandate Document RESTful API

API Details

If you want to upload a representation of the mandate/DDI, for example if you have a signed paper mandate, have scanned it and saved it as a PDF, you can upload this to Nuapay so that it is linked to the required mandate/DDI.

This can then be viewed later if you use the Retrieve Mandate Document service.


The Idempotency check is only against successful requests, so where a previous call has resulted in any of the following HTTP Response Codes, that Idempotency key may be reused without any issue:

  • 401
  • 403
  • 404
  • 408
  • 500
  • 501
  • 503