Create Direct Debit & Mandate RESTful API - generate a mandate and a payment in a single API call.

API Details

As outlined in the Create Direct Debit service, you must have an ACTIVE mandate/DDI before you can begin to collect Direct Debit payments. Typically you would use the Create Mandate endpoint and then reference the successfully activated mandate/DDI when you create the Direct Debit payment.

The Create Direct Debit and Mandate call allows you to combine these separate requests into a single call; the request performs two operations:

  • A mandate/DDI is created in ACTIVE status
  • A Direct Debit payment is created and linked to the new mandate/DDI

The Create Direct Debit and Mandate request must include:

  • A requested collection date for the Direct Debit payment
  • The payment amount
  • The payer’s name
  • The payer’s account details
  • The Merchant’s Nuapay IBAN


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