Bacs Direct Debit Mandate Initiation Response Confirmation

Mandate Initiation Response Confirmation message is sent to client to confirm or reject Mandate Response message.

Mandate Initiation Response Confirmation can be requested via the Messages service.

HTTP Header Message-Response-Type: DIRECT_DEBIT_MANDATE_CONFIRM

See the Examples section for a confirmation message.

Message structure

For this message, JSON format is used.

Name	Value	Description
GrpHdr.MsgId		Mandatory. Related pain.012 message id. (GrpHdr.MsgId from pain.012)
AcceptanceStatus	OK - All acceptances are processed successfully PARTIAL - Some of the acceptances failed to process FAILED - The file was failed to process	Mandatory. pain.012 fail processing status.
Messages.OrgnlMsgInf.MsgId		Mandatory. Original pain.009 message id. (GrpHdr.MsgId from pain.009)
Messages.Confirmed	true - response is confirmed false - response is not confirmed	Mandatory. Mandate response status: If the value is true, the mandate response was processed successfully. If the value is false, an error occurred and the ErrorInfo section is presented with error details.
Messages.ErrorInfo.ErrorCode	List of error codes can be found here	Optional. Only presented when Message.confirmed is false.
Messages.ErrorInfo.ErrorDescription	List of error code descriptions can be found here	Optional. Only presented when Message.confirmed is false.

OK

All mandate responses in pain.012 have been processed successfully.

{
  "GrpHdr.MsgId": "pain012_message_id",
  "AcceptanceStatus": "OK",
  "Messages": [
    {
      "OrgnlMsgInf.MsgId": "message_id_pain009",
      "Confirmed": true
    },
    {
      "OrgnlMsgInf.MsgId": "message_id_pain009_2",
      "Confirmed": true
    }
  ]
}

PARTIAL

Some mandate responses in pain.012 have failed to process.

{
  "GrpHdr.MsgId": "pain012_message_id",
  "AcceptanceStatus": "PARTIAL",
  "Messages": [
    {
      "OrgnlMsgInf.MsgId": "message_id_pain009",
      "Confirmed": true
    },
    {
      "OrgnlMsgInf.MsgId": "invalid_message_id",
      "Confirmed": false,
      "ErrorInfo": {
        "ErrorCode": "NOT_FOUND",
        "ErrorDescription": "Mandate not found"
      }
    }
  ]
}

FAILED

Pain.012 has failed to process.

{
  "GrpHdr.MsgId": "pain012_message_id",
  "AcceptanceStatus": "FAILED",
  "Messages": [
    {
      "OrgnlMsgInf.MsgId": "pain009_message_id",
      "Confirmed": false,
      "ErrorInfo": {
        "ErrorCode": "INVALID_ACCEPTANCE_DATA",
        "ErrorDescription": "Invalid acceptance data"
      }
    }
  ]
}

Error codes

Error Code	Error Description	Comment
MANDATE_NOT_FOUND	Mandate not found	Mandate does not exist. The pain.009 id may be invalid in pain.012 message (UndrlygAccptncDtls.OrgnlMsgInf.MsgId)
MANDATE_INVALID_STATUS	Mandate is expected to be in status PENDING, but is in status ...	A mandate can be confirmed or rejected only when it is in pending status. If the mandate is already confirmed, returned, activated, etc., it can no longer be accepted or rejected.
DUPLICATE_MESSAGE_ID	Duplicate message in file	There is duplicate pain.009 message id on pain.012 file.
MANDATE_FILE_NOT_FOUND	pain.009 message file not found	Original Mandate Initiation Request does not exist. The pain.009 id may be invalid in pain.012 message (UndrlygAccptncDtls.OrgnlMsgInf.MsgId)
NO_RIGHTS_TO_DEBTOR_ACCOUNT	User have no rights to debtor account	User have no rights to debtor account.
INVALID_ACCEPTANCE_DATA	Invalid acceptance data	Acceptance data in pain.012 is invalid. Status and reason code must be filled correctly.