Request a CODA mandate
Requests a mandate for the bank account.
The bank determines the product: a CODA mandate when the bank delivers CODA to Codaclean, otherwise a CODAlight consent through a connector.
Processing is asynchronous. The response confirms that the request was received, and contains no mandate identifier.
Follow the mandate with POST /mandates, for example filtered on customerId or iban, with updatedSince.
Do not repeat the request before the mandate appears there: until then, a duplicate request is not detected.
When several connectors match the bank, the call returns 422 connectorSelectionRequired with candidates. Call again with the chosen connectorId.
Required scope: mandates:write
Authorizations
Identifies the partner software. Issued by Codaclean. Required on every call, including POST /token.
Identifies the user and their accounting firm. Send the idToken returned by POST /token as Authorization: Bearer <idToken>. Valid for 1 hour.
Path Parameters
Customer identifier (24-character hexadecimal string), as returned in id.
IBAN of the bank account. Spaces are removed and letters are uppercased before use.
Body
Only needed when the call returned 422 connectorSelectionRequired: pick one of the returned candidates.
Response
Mandate request received.
Confirmation returned by actions that do not return a resource.

