NAV Navigation

Welcome

This documentation was last updated on Thu Aug 26 14:13:38 UTC 2021 and covers Version v1.35.7

Welcome to the Mambu Payments API documentation!

Our Payments API is independent from the existing Mambu API and WebHook infrastructure and allows you to manage payments made via the SEPA scheme.

The purpose of Payment Order capability is to orchestrate the movement of money between an account in Mambu and an account at a third-party financial institution (both domestic as well as international).

The orchestration includes triggering Payment Execution on the user-specified date, debiting / crediting the account in Mambu (i.e. calling transaction API), storing-and-forwarding the credit / debit instruction for settlement in a third party financial institution via the Payment Gateway, that in turn sends it out to Payment Network.

Before using the Payment Gateway you will need to carry out the steps outlined in our payments documentation, this includes setting up an API consumer, transaction channels and configuring your bank identification codes and job schedulers.

AML

If you are using an external service to check payments as part of your Anti Money Laundering obligations, these endpoints receive responses which will lead to unblocking funds and transferring them to the recipient account in the case of an all clear or returning funds to the payer in cases where there a compliance issue has been identified.

processAmlResponse

POST /v1/payments/aml

Accepts AML check results for Payment Orders.

Example Request

amlInformation

{
  "groupHeader": {
    "messageIdentification": "SCTORD200020190305ORD000011119"
  },
  "transactions": [
    {
      "status": "Accepted",
      "paymentIdentification": {
        "transactionIdentification": "00730100632BHGCRWC"
      },
      "debtorAgent": {
        "institutionIdentification": {
          "bicfi": "BTRLRO22"
        }
      },
      "interbankSettlementDate": "2019-06-28T00:00:00.000Z"
    }
  ]
}

Parameters

Name Type Description In Required
Content-Type string application/json header true
X-Request-ID string ID of the request, unique to the call, as determined by the initiating party. header true
Idempotency-Key string Prevents retried requests to be executed multiple times. Subsequent requests with the same Idempotency Key will not be processed and will return a cached result. header false
body AmlResult none body false

Example Responses

400 :
missingMandatoryField

{
  "tppMessages": [
    {
      "category": "ERROR",
      "code": "FORMAT_ERROR",
      "path": "groupHeader.messageIdentification",
      "text": "groupHeader.messageIdentification may not be null"
    }
  ]
}

405 :
unsupportedHttpMethod

{
  "tppMessages": [
    {
      "category": "ERROR",
      "code": "SERVICE_INVALID",
      "text": "There was an error processing your request. It has been logged (ID a449ea6319107e42)."
    }
  ]
}

415 :
unsupportedContentType

{
  "tppMessages": [
    {
      "category": "ERROR",
      "code": "SERVICE_INVALID",
      "text": "There was an error processing your request. It has been logged (ID a449ea6319107e42)."
    }
  ]
}

500 :
internalServerError

{
  "tppMessages": [
    {
      "category": "ERROR",
      "code": "SERVICE_INVALID",
      "text": "There was an error processing your request. It has been logged (ID a449ea6319107e42)."
    }
  ]
}

Responses

Status Meaning Description Schema
200 OK OK - The AML check result has been prepared for processing. None
400 Bad Request Bad Request - Validation error occurred. This code will cover malformed syntax in request or incorrect data in payload. FailedPaymentResponse
405 Method Not Allowed Method Not Allowed - This code is only sent when the HTTP method (PUT, POST, DELETE, GET etc.) is not supported on a specific endpoint. It has nothing to do with the consent, payment or account information data model. FailedPaymentResponse
415 Unsupported Media Type Unsupported Media Type - A media type which the serves does not support has been supplied. FailedPaymentResponse
500 Internal Server Error Internal Server Error - Internal server error occurred. FailedPaymentResponse
503 Service Unavailable Service Unavailable - The server is currently unavailable. Generally, this is a temporary state. None

External Account Representation

These endpoints are used to associate IBANs with Mambu account IDs so that payments made using the Payment Gateway are routed to the correct accounts.

createMapping

POST /v1/accounts/{accountId}/identifications

Adds association of an external account identification (IBAN or proprietary) to a Mambu Account. The currency of the association will be the one of the underlining Mambu account. If an IBAN is supposed to be a multi-currency one, this API needs to be invoked multiple times with different Mambu accounts (for the different currencies).

Example Request

createMambuAccountMapping

{
  "identification": {
    "other": {
      "identification": "ABCDE1234F",
      "scheme": "PAN"
    },
    "iban": "DE46606951125202071272"
  }
}

Parameters

Name Type Description In Required
Content-Type string application/json header true
accountId string none path true
body CreateAccountMapping none body false

Example Responses

201 :
accountMappingResponse

{}

400 :
invalidIdentification

{
  "tppMessages": [
    {
      "category": "ERROR",
      "code": "FORMAT_ERROR",
      "path": "iban",
      "text": "iban size must be between 15 and 34"
    },
    {
      "category": "ERROR",
      "code": "FORMAT_ERROR",
      "path": "iban",
      "text": "iban invalid IBAN value"
    }
  ]
}

500 :
internalServerError

{
  "tppMessages": [
    {
      "category": "ERROR",
      "code": "SERVICE_INVALID",
      "text": "There was an error processing your request. It has been logged (ID a449ea6319107e42)."
    }
  ]
}

Responses

Status Meaning Description Schema
201 Created Created - Association successfully created. AccountMappingResponse
400 Bad Request Bad Request - Validation error occurred. This code will cover malformed syntax in request or incorrect data in payload. FailedAccountMappingResponse
500 Internal Server Error Internal Server Error - Internal server error occurred. FailedAccountMappingResponse
503 Service Unavailable Service Unavailable - The server is currently unavailable. Generally, this is a temporary state. None

createMappings

PUT /v1/accounts/identifications

Create or replace associations of an external account identification (IBAN or proprietary) to a list of Mambu Accounts. The currency of the association will be the one of the underlining Mambu account.

Example Request

createMambuAccountMappings

{
  "identification": {
    "iban": "DE46606951125202071272"
  },
  "accountIds": [
    "123",
    "456",
    "789"
  ]
}

Parameters

Name Type Description In Required
Content-Type string application/json header true
body CreateAccountMappings none body false

Example Responses

201 :
accountMappingResponse

{}

400 :
invalidIdentification

{
  "tppMessages": [
    {
      "category": "ERROR",
      "code": "FORMAT_ERROR",
      "path": "iban",
      "text": "iban size must be between 15 and 34"
    },
    {
      "category": "ERROR",
      "code": "FORMAT_ERROR",
      "path": "iban",
      "text": "iban invalid IBAN value"
    }
  ]
}

500 :
internalServerError

{
  "tppMessages": [
    {
      "category": "ERROR",
      "code": "SERVICE_INVALID",
      "text": "There was an error processing your request. It has been logged (ID a449ea6319107e42)."
    }
  ]
}

Responses

Status Meaning Description Schema
201 Created Created - Association successfully created. AccountMappingResponse
400 Bad Request Bad Request - Validation error occurred. This code will cover malformed syntax in request or incorrect data in payload. FailedAccountMappingResponse
500 Internal Server Error Internal Server Error - Internal server error occurred. FailedAccountMappingResponse
503 Service Unavailable Service Unavailable - The server is currently unavailable. Generally, this is a temporary state. None

mask

POST /v1/accounts/identifications:mask

Mask identifications from Payments Gateway.

Example Request

{
  "identifications": [
    {
      "iban": "stringstringstr",
      "other": {
        "identification": "string",
        "scheme": "string"
      }
    }
  ]
}

Parameters

Name Type Description In Required
body IdentificationsToMask none body true

Example Responses

400 :
identificationAlreadyMasked

{
  "tppMessages": [
    {
      "category": "ERROR",
      "code": "SERVICE_INVALID",
      "text": "Following identifications are already masked: DK0643182702662691"
    }
  ]
}

500 :
internalServerError

{
  "tppMessages": [
    {
      "category": "ERROR",
      "code": "SERVICE_INVALID",
      "text": "There was an error processing your request. It has been logged (ID a449ea6319107e42)."
    }
  ]
}

Responses

Status Meaning Description Schema
200 OK OK - Identifications masked. This operation is irreversible. None
400 Bad Request Bad Request - Validation error occurred. This code will cover malformed syntax in request or incorrect data in payload. PaymentResponse
500 Internal Server Error Internal Server Error - Internal server error occurred. PaymentResponse
503 Service Unavailable Service Unavailable - The server is currently unavailable. Generally, this is a temporary state. None

searchAccountIdentifications

POST /v1/accounts/identifications:search

Searches identifications (with MambuID included) based on provided filter criteria

Example Request

{
  "filterCriteria": [
    {
      "field": "SCHEME",
      "operator": "EQUALS",
      "value": "string"
    }
  ]
}

Parameters

Name Type Description In Required
Content-Type string application/json header true
body AccountIdentificationsSearchRequestDTO none body false

Example Responses

200 :
AccountIdentificationsSearchResponse

[
  {
    "accountId": "test123",
    "currency": "EUR",
    "type": "DEPOSIT",
    "identification": {
      "iban": "DE46606951125202071272",
      "identification": "ABCDE1234F",
      "scheme": "PAN"
    }
  }
]

400 :
invalidSearchFilter

{
  "tppMessages": [
    {
      "category": "ERROR",
      "code": "FORMAT_ERROR",
      "path": "searchAccountIdentifications.arg0.filterCriteria[0].field",
      "text": "filterCriteria[0].field Should be one of: schema, iban, currency, identification"
    }
  ]
}

500 :
internalServerError

{
  "tppMessages": [
    {
      "category": "ERROR",
      "code": "SERVICE_INVALID",
      "text": "There was an error processing your request. It has been logged (ID a449ea6319107e42)."
    }
  ]
}

Responses

Status Meaning Description Schema
200 OK OK - List of found identifications with accountId Inline
400 Bad Request Bad Request - Validation error occurred. This code will cover malformed syntax in request or incorrect data in payload. FailedAccountMappingResponse
500 Internal Server Error Internal Server Error - Internal server error occurred. FailedAccountMappingResponse
503 Service Unavailable Service Unavailable - The server is currently unavailable. Generally, this is a temporary state. None

Response Schema

Status Code 200

Name Type Description Required Restrictions
anonymous [AccountIdentificationsSearchResponseDTO] none false none
» accountId string AccountID (Unique and unambiguous identification for the account.) true none
» currency string Account currency false none
» identification Identification Unique and unambiguous identification for the account. true none
»» iban string ISO 13616 International Bank Account Number (IBAN) - identifier used internationally by financial institutions to uniquely identify the account of a customer. false none
»» other Other Unique identification of an account, as assigned by the account servicer, using other identification scheme. false none
»»» identification string Identification assigned by an institution. true none
»»» scheme string Name of the identification scheme. true none
» type string Account type false none

SEPA Credit Transfers

These endpoints are used for making and receiving payments through the Mambu Payment Gateway.

initiatePayment

POST /v1/payments

Creates a payment initiation request.

Example Request

initiatePaymentRequest

{
  "instructedAmount": {
    "amount": "500",
    "currency": "EUR"
  },
  "requestedExecutionDate": "2021-12-21",
  "requestedExecutionTime": "2021-12-21T12:50:00.000+02:00",
  "localInstrument": "string",
  "serviceLevel": "SEPA",
  "paymentIdentification": {
    "endToEndIdentification": "string",
    "transactionIdentification": "string"
  },
  "creditorName": "Merchant123",
  "creditorAccount": {
    "currency": "EUR",
    "identification": {
      "iban": "DE16195554277485442959"
    }
  },
  "creditorIdentification": {
    "code": "stri",
    "issuer": "string",
    "privateIdentification": "string",
    "proprietary": "string"
  },
  "creditorAddress": {
    "buildingNumber": "1",
    "city": "Munich",
    "countryCode": "DE",
    "postalCode": "80809",
    "street": "Am Olympiapark 1"
  },
  "creditorAgent": {
    "institutionIdentification": {
      "bicfi": "DEUTDEFF"
    }
  },
  "debtorName": "Jefty Robbins",
  "debtorAccount": {
    "currency": "EUR",
    "identification": {
      "iban": "DE46606951125202071272"
    }
  },
  "debtorAddress": {
    "buildingNumber": "5234",
    "city": "Berlin",
    "countryCode": "DE",
    "postalCode": "10178",
    "street": "Karl-Liebknecht-Str. 5"
  },
  "debtorIdentification": {
    "code": "stri",
    "issuer": "string",
    "privateIdentification": "string",
    "proprietary": "string"
  },
  "debtorAgent": {
    "institutionIdentification": {
      "bicfi": "DEUTDEFF"
    }
  },
  "purposeCode": "stri",
  "remittanceInformationStructured": {
    "reference": "string",
    "referenceIssuer": "string",
    "referenceType": "string"
  },
  "remittanceInformationUnstructured": "string",
  "ultimateCreditor": "string",
  "ultimateDebtor": "string"
}

Parameters

Name Type Description In Required
Content-Type string application/json header true
X-Request-ID string ID of the request, unique to the call, as determined by the initiating party. header true
Idempotency-Key string Prevents retried requests to be executed multiple times. Subsequent requests with the same Idempotency Key will not be processed and will return a cached result. header false
body Payment none body false

Example Responses

201 :
initiatePaymentResponse

{
  "transactionStatus": "RCVD",
  "paymentId": "e38458a4-d955-4a39-8e21-9608e9600b3d",
  "transactionFeeIndicator": false
}

400 :
missingMandatoryField

{
  "tppMessages": [
    {
      "category": "ERROR",
      "code": "FORMAT_ERROR",
      "path": "debtorAccount.identification",
      "text": "debtorAccount.identification may not be null"
    }
  ]
}

405 :
unsupportedHttpMethod

{
  "tppMessages": [
    {
      "category": "ERROR",
      "code": "SERVICE_INVALID",
      "text": "There was an error processing your request. It has been logged (ID a449ea6319107e42)."
    }
  ]
}

415 :
unsupportedContentType

{
  "tppMessages": [
    {
      "category": "ERROR",
      "code": "SERVICE_INVALID",
      "text": "There was an error processing your request. It has been logged (ID a449ea6319107e42)."
    }
  ]
}

500 :
internalServerError

{
  "tppMessages": [
    {
      "category": "ERROR",
      "code": "SERVICE_INVALID",
      "text": "There was an error processing your request. It has been logged (ID a449ea6319107e42)."
    }
  ]
}

Responses

Status Meaning Description Schema
201 Created Created - Payment Initiation request was correctly performed (but not yet accepted) nor executed. PaymentResponse
400 Bad Request Bad Request - Validation error occurred. This code will cover malformed syntax in request or incorrect data in payload. FailedPaymentResponse
405 Method Not Allowed Method Not Allowed - This code is only sent when the HTTP method (PUT, POST, DELETE, GET etc.) is not supported on a specific endpoint. It has nothing to do with the consent, payment or account information data model. FailedPaymentResponse
415 Unsupported Media Type Unsupported Media Type - A media type which the serves does not support has been supplied. FailedPaymentResponse
500 Internal Server Error Internal Server Error - Internal server error occurred. FailedPaymentResponse
503 Service Unavailable Service Unavailable - The server is currently unavailable. Generally, this is a temporary state. None

Response Headers

Status Header Type Format Description
201 Location undefined Location of the created payment order request resource, for future reference or status polling.

incomingMessage

POST /v1/payments/incoming

Creates an incoming message request.

Example Request

incomingCreditTransferRequest

Parameters

Name Type Description In Required
Content-Type string application/xml header true
X-Request-ID string ID of the request, unique to the call, as determined by the initiating party. header true
Idempotency-Key string Prevents retried requests to be executed multiple times. Subsequent requests with the same Idempotency Key will not be processed and will return a cached result. header false

Example Responses

202 :
incomingPacs008Response

{
  "messageId": "SCTORD200020190305ORD000011119",
  "messageType": "urn:iso:std:iso:20022:tech:xsd:pacs.008.001.02"
}

202 :
incomingCamt056Response

{
  "messageId": "568R9154000000000000000000000000010",
  "messageType": "urn:iso:std:iso:20022:tech:xsd:camt.056.001.01"
}

400 :
invalidValueForField

{
  "tppMessages": [
    {
      "category": "ERROR",
      "code": "FORMAT_ERROR",
      "text": "The request body may not be empty"
    }
  ]
}

405 :
unsupportedHttpMethod

{
  "tppMessages": [
    {
      "category": "ERROR",
      "code": "SERVICE_INVALID",
      "text": "There was an error processing your request. It has been logged (ID a449ea6319107e42)."
    }
  ]
}

415 :
unsupportedContentType

{
  "tppMessages": [
    {
      "category": "ERROR",
      "code": "SERVICE_INVALID",
      "text": "There was an error processing your request. It has been logged (ID a449ea6319107e42)."
    }
  ]
}

500 :
internalServerError

{
  "tppMessages": [
    {
      "category": "ERROR",
      "code": "SERVICE_INVALID",
      "text": "There was an error processing your request. It has been logged (ID a449ea6319107e42)."
    }
  ]
}

Responses

Status Meaning Description Schema
202 Accepted Accepted - Incoming file accepted and is due for processing, when incoming scheduler is configured to run. Outgoing (complete / partial) pacs.002 will be published in case of complete / partial processing of incoming pacs.008. If the incoming pacs.008 is completely failed then a rejected pacs.002 will be published. Outgoing pacs.004 will be published for failed transaction from incoming pacs.008. IncomingPaymentResponse
400 Bad Request Bad Request - Validation error occurred. FailedPaymentResponse
405 Method Not Allowed Method Not Allowed - This code is only sent when the HTTP method (PUT, POST, DELETE, GET etc.) is not supported on a specific endpoint. It has nothing to do with the consent, payment or account information data model. FailedPaymentResponse
415 Unsupported Media Type Unsupported Media Type - A media type which the serves does not support has been supplied. FailedPaymentResponse
500 Internal Server Error Internal Server Error - Internal server error occurred. FailedPaymentResponse
503 Service Unavailable Service Unavailable - The server is currently unavailable. Generally, this is a temporary state. None

getPaymentDetails

GET /v1/payments/{paymentId}

Retrieve the payment initiation details.

Parameters

Name Type Description In Required
paymentId string ID of the payment order id, as received in the Payment Initiation response. path true
detailsLevel string Details level of the response. STATUS and FULL detail levels are supported. query false

Example Responses

200 :
paymentStatusDetailsResponse

{
  "transactionStatus": "ACSC",
  "lastStatusUpdateTimestamp": "2019-03-15T09:34:00.000Z"
}

200 :
paymentFullDetailsResponse

{
  "transactionStatus": "ACSC",
  "lastStatusUpdateTimestamp": "2019-03-15T09:34:00.000Z",
  "paymentIdentification": {
    "transactionIdentification": "SCTORD156820190401000000000010"
  },
  "debtorAccount": {
    "identification": {
      "iban": "DE46606951125202071272"
    },
    "currency": "EUR"
  },
  "debtorName": "John Doe",
  "serviceLevel": "SEPA",
  "instructedAmount": {
    "currency": "EUR",
    "amount": "500"
  },
  "creditorAccount": {
    "identification": {
      "iban": "DE16195554277485442959"
    },
    "currency": "EUR"
  },
  "creditorAgent": {
    "institutionIdentification": {
      "bicfi": "DEUTDEFF"
    }
  },
  "creditorName": "Merchant123",
  "product": "SEPA_CREDIT_TRANSFER",
  "direction": "OUTGOING"
}

400 :
missingDetailsForPaymentId

{
  "tppMessages": [
    {
      "category": "ERROR",
      "code": "SERVICE_INVALID",
      "path": "paymentId",
      "text": "Unable to find payment details for payment 123"
    }
  ]
}

405 :
unsupportedHttpMethod

{
  "tppMessages": [
    {
      "category": "ERROR",
      "code": "SERVICE_INVALID",
      "text": "There was an error processing your request. It has been logged (ID a449ea6319107e42)."
    }
  ]
}

406 :
unsupportedAcceptType

{
  "tppMessages": [
    {
      "category": "ERROR",
      "code": "SERVICE_INVALID",
      "text": "There was an error processing your request. It has been logged (ID a449ea6319107e42)."
    }
  ]
}

500 :
internalServerError

{
  "tppMessages": [
    {
      "category": "ERROR",
      "code": "SERVICE_INVALID",
      "text": "There was an error processing your request. It has been logged (ID a449ea6319107e42)."
    }
  ]
}

Responses

Status Meaning Description Schema
200 OK OK - Payment Initiation Details were correctly found. PaymentDetails
400 Bad Request Bad Request - Validation error occurred. This code will cover malformed syntax in request or incorrect data in payload. FailedPaymentResponse
405 Method Not Allowed Method Not Allowed - This code is only sent when the HTTP method (PUT, POST, DELETE, GET etc.) is not supported on a specific endpoint. It has nothing to do with the consent, payment or account information data model. FailedPaymentResponse
406 Not Acceptable Not Acceptable - A media type which the serves does not support has been supplied. FailedPaymentResponse
500 Internal Server Error Internal Server Error - Internal server error occurred. FailedPaymentResponse
503 Service Unavailable Service Unavailable - The server is currently unavailable. Generally, this is a temporary state. None

manuallyRejectOutgoingPayment

POST /v1/payments/{paymentOrderId}:reject

Manually Reject an Outgoing Payment.

Parameters

Name Type Description In Required
paymentOrderId string none path true

Example Responses

400 :
invalidTransactionStatus

{
  "tppMessages": [
    {
      "category": "ERROR",
      "code": "INVALID_TRANSACTION_STATUS",
      "text": "Transaction has invalid status: TO_BE_REJECTED. Expected status is: TO_BE_SENT."
    }
  ]
}

500 :
internalServerError

{
  "tppMessages": [
    {
      "category": "ERROR",
      "code": "SERVICE_INVALID",
      "text": "There was an error processing your request. It has been logged (ID a449ea6319107e42)."
    }
  ]
}

Responses

Status Meaning Description Schema
200 OK OK - The specified payment order has been marked to be manually rejected. None
400 Bad Request Bad Request - Validation error occurred. This code will cover malformed syntax in request or incorrect data in payload. PaymentResponse
500 Internal Server Error Internal Server Error - Internal server error occurred. PaymentResponse
503 Service Unavailable Service Unavailable - The server is currently unavailable. Generally, this is a temporary state. None

findSepaMessages

GET /v1/instructions

Retrieve the SEPA messages details.

Parameters

Name Type Description In Required
sepaMessageFilter SepaMessageFilter none query true

Example Responses

200 :
pacs.008 instruction information

{
  "instructions": [
    {
      "FIToFICstmrCdtTrf": {
        "grpHdr": {
          "msgId": "22b8f938c6154877886a0c1fc9e74166",
          "creDtTm": "2019-04-11T06:08:45.000Z",
          "nbOfTxs": "2",
          "ttlIntrBkSttlmAmt": {
            "value": 200,
            "ccy": "EUR"
          },
          "intrBkSttlmDt": "2019-04-10T21:00:00.000Z",
          "sttlmInf": {
            "clrSys": {
              "prtry": "ST2"
            }
          },
          "instgAgt": {
            "finInstnId": {
              "bic": "ABVRATW1XXX"
            }
          }
        },
        "cdtTrfTxInf": [
          {
            "pmtId": {
              "instrId": "82d7125b36014c2e8cc442a3586badd0",
              "endToEndId": "NOTPROVIDED",
              "txId": "4112f6688c846a89bee2b2c476f1145"
            },
            "pmtTpInf": {
              "svcLvl": {
                "cd": "SEPA"
              }
            },
            "intrBkSttlmAmt": {
              "value": 100,
              "ccy": "EUR"
            },
            "accptncDtTm": "2019-04-11T06:08:45.000Z",
            "chrgBr": "SLEV",
            "dbtr": {
              "nm": "John Doe"
            },
            "dbtrAcct": {
              "id": {
                "iban": "RO59INGBW91QIQFZSG6IZBJT"
              }
            },
            "dbtrAgt": {
              "finInstnId": {
                "bic": "INGBROBU"
              }
            },
            "cdtrAgt": {
              "finInstnId": {
                "bic": "BTRLRO22"
              }
            },
            "cdtr": {
              "nm": "BT",
              "pstlAdr": {
                "ctry": "DE"
              }
            },
            "cdtrAcct": {
              "id": {
                "iban": "RO75BTRLBSIJS00RPQWYLYWL"
              }
            },
            "_metadata": {
              "transactionSn": 1,
              "transactionStatus": "RECEIVED",
              "paymentId": "67eacbf33f1b4eaea8d1055a2a01adea"
            }
          },
          {
            "pmtId": {
              "instrId": "108cf3f5fd833aa5bc5efb90c0dee19e",
              "endToEndId": "NOTPROVIDED",
              "txId": "758e663666ae40be8e9278a9e4e899f9"
            },
            "pmtTpInf": {
              "svcLvl": {
                "cd": "SEPA"
              }
            },
            "intrBkSttlmAmt": {
              "value": 100,
              "ccy": "EUR"
            },
            "accptncDtTm": "2019-04-11T06:08:45.000Z",
            "chrgBr": "SLEV",
            "dbtr": {
              "nm": "John Doe"
            },
            "dbtrAcct": {
              "id": {
                "iban": "RO59INGBW91QIQFZSG6IZBJT"
              }
            },
            "dbtrAgt": {
              "finInstnId": {
                "bic": "INGBROBU"
              }
            },
            "cdtrAgt": {
              "finInstnId": {
                "bic": "BTRLRO22"
              }
            },
            "cdtr": {
              "nm": "BT",
              "pstlAdr": {
                "ctry": "DE"
              }
            },
            "cdtrAcct": {
              "id": {
                "iban": "RO94BTRLVU048EN2KBPTVT7U"
              }
            },
            "_metadata": {
              "transactionSn": 2,
              "transactionStatus": "RECEIVED",
              "paymentId": "fcaae256fed94018958326c9cb752aeb"
            }
          }
        ],
        "_metadata": {
          "bulkSn": 1,
          "direction": "I",
          "messageId": "pacs.008",
          "transactions": 2
        }
      }
    }
  ]
}

200 :
pacs.004 instruction information

{
  "instructions": [
    {
      "PmtRtr": {
        "grpHdr": {
          "msgId": "1",
          "creDtTm": "2018-11-26T19:47:57.000Z",
          "nbOfTxs": "1",
          "ttlRtrdIntrBkSttlmAmt": {
            "value": 4000.5,
            "ccy": "EUR"
          },
          "intrBkSttlmDt": "2018-11-25T22:00:00.000Z",
          "sttlmInf": {
            "sttlmMtd": "CLRG",
            "clrSys": {
              "prtry": "ST2"
            }
          }
        },
        "txInf": [
          {
            "rtrId": "2020181126130827322001",
            "orgnlGrpInf": {
              "orgnlMsgId": "1231231312",
              "orgnlMsgNmId": "pacs.008"
            },
            "orgnlEndToEndId": "10864caa82034bc8a12e4bf3e117d10d",
            "orgnlTxId": "8097758122275259",
            "rtrdIntrBkSttlmAmt": {
              "value": 4000.5,
              "ccy": "EUR"
            },
            "rtrRsnInf": {
              "orgtr": {
                "id": {
                  "orgId": {
                    "bicorBEI": "DABADKKK"
                  }
                }
              },
              "rsn": {
                "cd": "AC_01"
              }
            },
            "orgnlTxRef": {
              "intrBkSttlmDt": "2018-11-25T22:00:00.000Z",
              "sttlmInf": {
                "sttlmMtd": "CLRG"
              },
              "pmtTpInf": {
                "svcLvl": {
                  "cd": "SEPA"
                }
              },
              "dbtr": {
                "nm": "Hanne Doe"
              },
              "dbtrAcct": {
                "id": {
                  "iban": "DK0643182702662691"
                }
              },
              "dbtrAgt": {
                "finInstnId": {
                  "bic": "DABADKKK"
                }
              },
              "cdtrAgt": {
                "finInstnId": {
                  "bic": "BTRLRO22"
                }
              },
              "cdtr": {
                "nm": "John Doe"
              },
              "cdtrAcct": {
                "id": {
                  "iban": "RO69BTRL3333444433334444"
                }
              }
            },
            "_metadata": {
              "transactionSn": 14,
              "transactionStatus": "RECEIVED",
              "returnReason": "AC01",
              "paymentId": "22886adc407e4280b7df22a966d08425"
            }
          }
        ],
        "_metadata": {
          "bulkSn": 10,
          "direction": "I",
          "messageId": "pacs.004.001.02",
          "procstatus": "REPLIED",
          "transactions": 1
        }
      }
    }
  ]
}

200 :
camt.056 instruction information

{
  "instructions": [
    {
      "FIToFIPmtCxlReq": {
        "assgnmt": {
          "id": "msg-id-camt.056.001.01",
          "assgnr": {
            "agt": {
              "finInstnId": {
                "bic": "TESTXXXXXXX"
              }
            }
          },
          "assgne": {
            "agt": {
              "finInstnId": {
                "bic": "TESTXXXXXXX"
              }
            }
          },
          "creDtTm": "2019-05-14T21:00:00.000+0000"
        },
        "ctrlData": {
          "nbOfTxs": 1
        },
        "undrlyg": [
          {
            "txInf": {
              "cxlId": "000R9087000000011",
              "orgnlGrpInf": {
                "orgnlMsgId": "SCTORD15682019",
                "orgnlMsgNmId": "pacs.008.001.02"
              },
              "orgnlInstrId": "6630844036108666",
              "orgnlEndToEndId": "NOTPROVIDED",
              "orgnlTxId": "8097758122275259",
              "orgnlIntrBkSttlmAmt": {
                "value": 4000.5,
                "ccy": "EUR"
              },
              "orgnlIntrBkSttlmDt": "2019-06-19T21:00:00.000+0000",
              "cxlRsnInf": [
                {
                  "orgtr": {
                    "nm": "Beneficioso beneficiar io"
                  },
                  "rsn": {
                    "cd": "DUPL"
                  }
                }
              ],
              "orgnlTxRef": {
                "sttlmInf": {
                  "sttlmMtd": "CLRG",
                  "clrSys": {
                    "cd": "REP"
                  }
                },
                "pmtTpInf": {
                  "svcLvl": {
                    "cd": "SEPA"
                  }
                },
                "rmtInf": {
                  "ustrd": [
                    "Pruebas para CECA 1"
                  ]
                },
                "ultmtDbtr": {
                  "nm": "EUR"
                },
                "dbtr": {
                  "nm": "ENRIQUE ROMERA MARTINEZ DE MIGUEL"
                },
                "dbtrAcct": {
                  "id": {
                    "iban": "ES1011110001087939390799"
                  }
                },
                "dbtrAgt": {
                  "finInstnId": {
                    "bic": "TESTXXXXXXX"
                  }
                },
                "cdtrAgt": {
                  "finInstnId": {
                    "bic": "TESTXXXXXXX"
                  }
                },
                "cdtr": {
                  "nm": "Beneficioso beneficiario"
                },
                "cdtrAcct": {
                  "id": {
                    "iban": "ES6520950001153279157264"
                  }
                }
              },
              "_metadata": {
                "transactionSn": 2,
                "transactionStatus": "TO_BE_SENT",
                "returnReason": "DUPL",
                "paymentId": "poId"
              }
            }
          }
        ],
        "_metadata": {
          "bulkSn": 2,
          "direction": "I",
          "messageId": "camt.056.001.01",
          "procstatus": "RETRIEVED",
          "transactions": 1
        }
      }
    }
  ]
}

200 :
camt.029 instruction information

{
  "instructions": [
    {
      "RsltnOfInvstgtn": {
        "assgnmt": {
          "id": "msg-id-camt.029.001.03",
          "assgnr": {
            "agt": {
              "finInstnId": {
                "bic": "TESTXXXXXXX"
              }
            }
          },
          "assgne": {
            "agt": {
              "finInstnId": {
                "bic": "TESTXXXXXXX"
              }
            }
          },
          "creDtTm": "2019-05-14T21:00:00.000+0000"
        },
        "sts": {
          "conf": "RJCT"
        },
        "cxlDtls": [
          {
            "txInfAndSts": {
              "cxlStsId": "568R9",
              "orgnlGrpInf": {
                "orgnlMsgId": "SCTORD156820190620000000000001",
                "orgnlMsgNmId": "pacs.008.001.02"
              },
              "orgnlInstrId": "a5fbae19e3d24522963ad60d018f2e49",
              "orgnlEndToEndId": "7456b0bb2c1a4209b87b4636995c5d08",
              "orgnlTxId": "1002",
              "txCxlSts": "RJCR",
              "cxlStsRsnInf": [
                {
                  "orgtr": {
                    "id": {
                      "orgId": {
                        "bicorBEI": "TESTXXXXXXX"
                      }
                    }
                  },
                  "rsn": {
                    "cd": "AGNT"
                  }
                }
              ],
              "orgnlTxRef": {
                "intrBkSttlmAmt": {
                  "value": 4000.5,
                  "ccy": "EUR"
                },
                "intrBkSttlmDt": "2019-06-19T21:00:00.000+0000",
                "sttlmInf": {
                  "sttlmMtd": "CLRG",
                  "clrSys": {
                    "prtry": "ACHT1234567890123456789012345678905"
                  }
                },
                "pmtTpInf": {
                  "svcLvl": {
                    "cd": "SEPA"
                  }
                },
                "rmtInf": {
                  "ustrd": [
                    "Pruebas para CECA 1"
                  ]
                },
                "dbtr": {
                  "nm": "ENRIQUE ROMERA MARTINEZ DE MIGUEL"
                },
                "dbtrAcct": {
                  "id": {
                    "iban": "ES1011110001087939390799"
                  }
                },
                "dbtrAgt": {
                  "finInstnId": {
                    "bic": "TESTXXXXXXX"
                  }
                },
                "cdtrAgt": {
                  "finInstnId": {
                    "bic": "TESTXXXXXXX"
                  }
                },
                "cdtr": {
                  "nm": "Beneficioso beneficiario"
                },
                "cdtrAcct": {
                  "id": {
                    "iban": "ES6520950001153279157264"
                  }
                }
              },
              "_metadata": {
                "transactionSn": 3,
                "transactionStatus": "TO_BE_SENT",
                "returnReason": "RJCT",
                "paymentId": "poId"
              }
            }
          }
        ],
        "_metadata": {
          "bulkSn": 3,
          "direction": "O",
          "messageId": "camt.029.001.03",
          "procstatus": "RETRIEVED",
          "transactions": 1
        }
      }
    }
  ]
}

400 :
invalidDirection

{
  "tppMessages": [
    {
      "category": "ERROR",
      "code": "PARAMETER_NOT_SUPPORTED",
      "text": "direction invalid value: example_invalid_direction"
    }
  ]
}

500 :
internalServerError

{
  "tppMessages": [
    {
      "category": "ERROR",
      "code": "SERVICE_INVALID",
      "text": "There was an error processing your request. It has been logged (ID a449ea6319107e42)."
    }
  ]
}

Responses

Status Meaning Description Schema
200 OK OK - SEPA Messages Details were correctly found. SepaMessages
400 Bad Request Bad Request - Validation error occurred. This code will cover malformed syntax in request or incorrect data in payload. PaymentResponse
500 Internal Server Error Internal Server Error - Internal server error occurred. PaymentResponse
503 Service Unavailable Service Unavailable - The server is currently unavailable. Generally, this is a temporary state. None

SEPA Credit Transfer Inquiries

These APIs allow you to submit inquiries for SEPA payments including for cases where the customer claims to have not received the funds, the value date was not correctly recorded or to request a status update for payments which have been cancelled.

requestStatusUpdateOnRecall

POST /v1/inquiries:requestStatusUpdateOnRecall

Create inquiry to request status update for a payment cancellation.

Example Request

{
  "cancellationIdentification": "string",
  "groupHeader": {
    "messageIdentification": "string"
  },
  "historicCancellationRequest": "string"
}

Parameters

Name Type Description In Required
body OriginalCamt056Data none body true

Example Responses

400 :
originalTransactionNotFound

500 :
internalServerError

Responses

Status Meaning Description Schema
200 OK OK - Inquiry created successfully. None
400 Bad Request Bad Request - The original Payment Cancellation Request transaction not found. Please check the input parameters. PaymentResponse
500 Internal Server Error Internal Server Error - Internal server error occurred. PaymentResponse
503 Service Unavailable Service Unavailable - The server is currently unavailable. Generally, this is a temporary state. None

requestStatusUpdateOnInquiry

POST /v1/inquiries:requestStatusUpdateOnInquiry

Create status update request for existing camt.087 or camt.027 inquiry

Example Request

{
  "assignment": {
    "creationDateTime": "2019-08-24T14:15:22Z",
    "identification": "string"
  },
  "caseIdentification": "string",
  "historicClaimRequest": "string",
  "messageTypeName": "PACS_002_001_03"
}

Parameters

Name Type Description In Required
body OriginalInquiryData none body true

Example Responses

400 :
originalTransactionNotFound

500 :
internalServerError

Responses

Status Meaning Description Schema
200 OK OK - Inquiry created successfully. None
400 Bad Request Bad Request - The original Credit transfer transaction not found. Please check the input parameters. PaymentResponse
500 Internal Server Error Internal Server Error - Internal server error occurred. PaymentResponse
503 Service Unavailable Service Unavailable - The server is currently unavailable. Generally, this is a temporary state. None

claimValueDateCorrection

POST /v1/inquiries:claimValueDateCorrection

Create inquiry to request claim for value-date change.

Example Request

{
  "claimedValueDate": "2019-08-24",
  "groupHeader": {
    "messageIdentification": "string",
    "settlementDate": "2019-08-24"
  },
  "historicCreditTransferRequest": "string",
  "paymentIdentification": {
    "endToEndIdentification": "string",
    "transactionIdentification": "string"
  }
}

Parameters

Name Type Description In Required
body OriginalPacs008Data none body true

Example Responses

400 :
originalTransactionNotFound

500 :
internalServerError

Responses

Status Meaning Description Schema
200 OK OK - Inquiry created successfully. None
400 Bad Request Bad Request - The original Credit Transfer transaction not found. Please check the input parameters. PaymentResponse
500 Internal Server Error Internal Server Error - Internal server error occurred. PaymentResponse
503 Service Unavailable Service Unavailable - The server is currently unavailable. Generally, this is a temporary state. None

claimNonReceipt

POST /v1/inquiries:claimNonReceipt

Create inquiry for claim of non-receipt

Example Request

{
  "claimedValueDate": "2019-08-24",
  "groupHeader": {
    "messageIdentification": "string",
    "settlementDate": "2019-08-24"
  },
  "historicCreditTransferRequest": "string",
  "paymentIdentification": {
    "endToEndIdentification": "string",
    "transactionIdentification": "string"
  }
}

Parameters

Name Type Description In Required
body OriginalPacs008Data none body true

Example Responses

400 :
originalTransactionNotFound

500 :
internalServerError

Responses

Status Meaning Description Schema
200 OK OK - Inquiry created successfully. None
400 Bad Request Bad Request - The original Credit transfer transaction not found. Please check the input parameters. PaymentResponse
500 Internal Server Error Internal Server Error - Internal server error occurred. PaymentResponse
503 Service Unavailable Service Unavailable - The server is currently unavailable. Generally, this is a temporary state. None

acceptStatusUpdateOnRecall

POST /v1/inquiries:acceptStatusUpdateOnRecall

Handles positive response for Request for Status Update on Recall with given details.

Example Request

acceptStatusUpdateOnRecall

{
  "groupHeader": {
    "messageIdentification": "82d7125b36014c2e8cc442a3586badd0",
    "creationDateTime": "2021-02-10T10:03:25.000Z",
    "instructingAgent": "ABCDE123"
  },
  "transactionInformation": {
    "statusRequestIdentification": "4112f6688c846a89bee2b2c476f1145",
    "originalMessageIdentification": "22b8f938c6154877886a0c1fc9e74166",
    "originalInstructionIdentification": "562f8f9f8c6154844886a0c1fc9e7451"
  }
}

Parameters

Name Type Description In Required
body AcceptStatusUpdateOnRecall none body true

Example Responses

400 :
invalidValueForField

{
  "tppMessages": [
    {
      "category": "ERROR",
      "code": "FORMAT_ERROR",
      "text": "The request body must not be empty"
    }
  ]
}

404 :
messageNotFound

{
  "tppMessages": [
    {
      "category": "ERROR",
      "code": "NOT_FOUND",
      "text": "No pacs.028.001.01 was found for the supplied details"
    }
  ]
}

405 :
unsupportedHttpMethod

{
  "tppMessages": [
    {
      "category": "ERROR",
      "code": "SERVICE_INVALID",
      "text": "There was an error processing your request. It has been logged (ID a449ea6319107e42)."
    }
  ]
}

415 :
unsupportedContentType

{
  "tppMessages": [
    {
      "category": "ERROR",
      "code": "SERVICE_INVALID",
      "text": "There was an error processing your request. It has been logged (ID a449ea6319107e42)."
    }
  ]
}

500 :
internalServerError

{
  "tppMessages": [
    {
      "category": "ERROR",
      "code": "SERVICE_INVALID",
      "text": "There was an error processing your request. It has been logged (ID a449ea6319107e42)."
    }
  ]
}

Responses

Status Meaning Description Schema
200 OK OK - Request for Status Update on Recall positive response was received None
400 Bad Request Bad Request - Validation error occurred. PaymentResponse
404 Not Found Not Found - No message found for the given identification. PaymentResponse
405 Method Not Allowed Method Not Allowed - This code is only sent when the HTTP method (PUT, POST, DELETE, GET etc.) is not supported on a specific endpoint. It has nothing to do with the consent, payment or account information data model. PaymentResponse
415 Unsupported Media Type Unsupported Media Type - A media type which the server does not support has been supplied. PaymentResponse
500 Internal Server Error Internal Server Error - Internal server error occurred. PaymentResponse
503 Service Unavailable Service Unavailable - The server is currently unavailable. Generally, this is a temporary state. None

SEPA Direct Debit

SEPA Direct Debit Payments are one time or recurring payments made using the Single European Payment Area scheme for transactions made in Euros between accounts at banks within the SEPA area, which includes all EU countries as well as other territories such as Liechtenstein, Switzerland, the United Kingdom, Andorra and Nordic countries.

Mambu supports both the Core SEPA rulebook for individuals and the B2B scheme for companies.

initiateCollection

POST /v1/collections

Creates a collection initiation request.

Example Request

initiateCollectionRequest

{
  "debtorAccount": {
    "identification": {
      "iban": "DE46606951125202071272"
    },
    "currency": "EUR"
  },
  "debtorName": "John Doe",
  "serviceLevel": "SEPA",
  "instructedAmount": {
    "currency": "EUR",
    "amount": "500"
  },
  "creditorAccount": {
    "identification": {
      "iban": "DE16195554277485442959"
    },
    "currency": "EUR"
  },
  "creditorName": "Merchant123",
  "paymentIdentification": {
    "transactionIdentification": "113T9bs6ad48ga1216d772430401s01sd2"
  },
  "requestedExecutionDate": "2020-09-01",
  "mandateRelatedInformation": {
    "mandateIdentification": "16ead91c975c4881a60c",
    "dateOfSignature": "2020-01-31"
  },
  "paymentTypeInformation": {
    "sequenceType": "FRST"
  },
  "creditorSchemeIdentification": {
    "identification": {
      "privateIdentification": "I48799148795"
    }
  }
}

Parameters

Name Type Description In Required
Content-Type string application/json header true
X-Request-ID string ID of the request, unique to the call, as determined by the initiating party. header true
Idempotency-Key string Prevents retried requests to be executed multiple times. Subsequent requests with the same Idempotency Key will not be processed and will return a cached result. header false
body Collection none body false

Example Responses

201 :
initiateCollectionResponse

{
  "transactionStatus": "RCVD",
  "collectionId": "e38458a4-d955-4a39-8e21-9608e9600b3d"
}

400 :
missingMandatoryField

{
  "tppMessages": [
    {
      "category": "ERROR",
      "code": "FORMAT_ERROR",
      "path": "debtorAccount.identification",
      "text": "debtorAccount.identification may not be null"
    }
  ]
}

405 :
unsupportedHttpMethod

{
  "tppMessages": [
    {
      "category": "ERROR",
      "code": "SERVICE_INVALID",
      "text": "There was an error processing your request. It has been logged (ID a449ea6319107e42)."
    }
  ]
}

415 :
unsupportedContentType

{
  "tppMessages": [
    {
      "category": "ERROR",
      "code": "SERVICE_INVALID",
      "text": "There was an error processing your request. It has been logged (ID a449ea6319107e42)."
    }
  ]
}

500 :
internalServerError

{
  "tppMessages": [
    {
      "category": "ERROR",
      "code": "SERVICE_INVALID",
      "text": "There was an error processing your request. It has been logged (ID a449ea6319107e42)."
    }
  ]
}

Responses

Status Meaning Description Schema
201 Created Created - Collection Initiation request was correctly performed (but not yet accepted) nor executed. CollectionResponse
400 Bad Request Bad Request - Validation error occurred. This code will cover malformed syntax in request or incorrect data in payload. FailedPaymentResponse
405 Method Not Allowed Method Not Allowed - This code is only sent when the HTTP method (PUT, POST, DELETE, GET etc.) is not supported on a specific endpoint. It has nothing to do with the consent, payment or account information data model. FailedPaymentResponse
415 Unsupported Media Type Unsupported Media Type - A media type which the serves does not support has been supplied. FailedPaymentResponse
500 Internal Server Error Internal Server Error - Internal server error occurred. FailedPaymentResponse
503 Service Unavailable Service Unavailable - The server is currently unavailable. Generally, this is a temporary state. None

Response Headers

Status Header Type Format Description
201 Location undefined Location of the created collection order request resource, for future reference or status polling.

reverse

POST /v1/collections/{collectionId}:reverse

Reverse a Collection Instruction.

Example Request

{
  "reasonCode": "AM05"
}

Parameters

Name Type Description In Required
collectionId string none path true
body Reverse none body true

Example Responses

400 :
badReversalReasonCode

500 :
internalServerError

Responses

Status Meaning Description Schema
200 OK OK - Collection Instruction marked to be reversed successfully. None
400 Bad Request Bad Request - Validation error occurred. This code will cover malformed syntax in request or incorrect data in payload. PaymentResponse
500 Internal Server Error Internal Server Error - Internal server error occurred. PaymentResponse
503 Service Unavailable Service Unavailable - The server is currently unavailable. Generally, this is a temporary state. None

refund

POST /v1/collections/{collectionId}:refund

Refund a Collection Instruction.

Example Request

{
  "reasonCode": "MD01"
}

Parameters

Name Type Description In Required
collectionId string none path true
body Refund none body true

Example Responses

400 :
badRefundReasonCode

{
  "tppMessages": [
    {
      "category": "ERROR",
      "code": "PARAMETER_NOT_SUPPORTED",
      "text": "value 'MD02' not supported"
    }
  ]
}

500 :
internalServerError

{
  "tppMessages": [
    {
      "category": "ERROR",
      "code": "SERVICE_INVALID",
      "text": "There was an error processing your request. It has been logged (ID a449ea6319107e42)."
    }
  ]
}

Responses

Status Meaning Description Schema
200 OK OK - Collection Instruction marked to be refunded successfully. None
400 Bad Request Bad Request - Validation error occurred. This code will cover malformed syntax in request or incorrect data in payload. PaymentResponse
500 Internal Server Error Internal Server Error - Internal server error occurred. PaymentResponse
503 Service Unavailable Service Unavailable - The server is currently unavailable. Generally, this is a temporary state. None

createBlockingRule

POST /v1/accounts/{accountId}/blocking-rules

Request a blocking rule to be added to a specific Mambu account.

Example Request

createCeditorMandateBlockingRule

{
  "product": "SEPA_DIRECT_DEBIT",
  "creditorMandate": {
    "mandateRelatedInformation": {
      "mandateIdentification": "578798984"
    },
    "creditorSchemeIdentification": {
      "identification": {
        "privateIdentification": "ID777444887"
      }
    }
  }
}

Parameters

Name Type Description In Required
Content-Type string application/json header true
accountId string ID of the Mambu Deposit account. path true
body CreateBlockingRule none body false

Example Responses

400 :
productCannotBeBlocked

{
  "tppMessages": [
    {
      "category": "ERROR",
      "code": "PARAMETER_NOT_SUPPORTED",
      "path": "product",
      "text": "SEPA_CREDIT_TRANSFER cannot be blocked"
    }
  ]
}

405 :
unsupportedHttpMethod

{
  "tppMessages": [
    {
      "category": "ERROR",
      "code": "SERVICE_INVALID",
      "text": "There was an error processing your request. It has been logged (ID a449ea6319107e42)."
    }
  ]
}

415 :
unsupportedContentType

{
  "tppMessages": [
    {
      "category": "ERROR",
      "code": "SERVICE_INVALID",
      "text": "There was an error processing your request. It has been logged (ID a449ea6319107e42)."
    }
  ]
}

500 :
internalServerError

{
  "tppMessages": [
    {
      "category": "ERROR",
      "code": "SERVICE_INVALID",
      "text": "There was an error processing your request. It has been logged (ID a449ea6319107e42)."
    }
  ]
}

Responses

Status Meaning Description Schema
202 Accepted Accepted - The Blocking Rule has been prepared for processing. None
400 Bad Request Bad Request - Validation error occurred. This code will cover malformed syntax in request or incorrect data in payload. FailedPaymentResponse
405 Method Not Allowed Method Not Allowed - This code is only sent when the HTTP method (PUT, POST, DELETE, GET etc.) is not supported on a specific endpoint. It has nothing to do with the consent, payment or account information data model. FailedPaymentResponse
415 Unsupported Media Type Unsupported Media Type - A media type which the serves does not support has been supplied. FailedPaymentResponse
500 Internal Server Error Internal Server Error - Internal server error occurred. FailedPaymentResponse
503 Service Unavailable Service Unavailable - The server is currently unavailable. Generally, this is a temporary state. None

deleteBlockingRules

DELETE /v1/accounts/{accountId}/blocking-rules

Request deletion of all blocking rules for the specified Mambu account.

Example Request

deleteAllBlockingRules

undefined

Parameters

Name Type Description In Required
Content-Type string application/json header true
accountId string ID of the Mambu Deposit account. path true
body DeleteBlockingRule none body false

Example Responses

405 :
unsupportedHttpMethod

{
  "tppMessages": [
    {
      "category": "ERROR",
      "code": "SERVICE_INVALID",
      "text": "There was an error processing your request. It has been logged (ID a449ea6319107e42)."
    }
  ]
}

415 :
unsupportedContentType

{
  "tppMessages": [
    {
      "category": "ERROR",
      "code": "SERVICE_INVALID",
      "text": "There was an error processing your request. It has been logged (ID a449ea6319107e42)."
    }
  ]
}

500 :
internalServerError

{
  "tppMessages": [
    {
      "category": "ERROR",
      "code": "SERVICE_INVALID",
      "text": "There was an error processing your request. It has been logged (ID a449ea6319107e42)."
    }
  ]
}

Responses

Status Meaning Description Schema
202 Accepted Accepted - Blocking rules for the specified account have been submitted for deletion. None
405 Method Not Allowed Method Not Allowed - This code is only sent when the HTTP method (PUT, POST, DELETE, GET etc.) is not supported on a specific endpoint. It has nothing to do with the consent, payment or account information data model. FailedPaymentResponse
415 Unsupported Media Type Unsupported Media Type - A media type which the serves does not support has been supplied. FailedPaymentResponse
500 Internal Server Error Internal Server Error - Internal server error occurred. FailedPaymentResponse
503 Service Unavailable Service Unavailable - The server is currently unavailable. Generally, this is a temporary state. None

paymentDetails

GET /v1/collections/{collectionId}

Retrieve the collection initiation details.

Parameters

Name Type Description In Required
collectionId string ID of the collection order id, as received in the Payment Initiation response. path true
detailsLevel string Details level of the response. STATUS and FULL detail levels are supported. query false

Example Responses

200 :
collectionFullDetailsResponse

{
  "transactionStatus": "ACSC",
  "lastStatusUpdateTimestamp": "2019-03-15T09:34:00.000Z",
  "paymentIdentification": {
    "transactionIdentification": "SCTORD156820190401000000000010"
  },
  "debtorAccount": {
    "identification": {
      "iban": "DE46606951125202071272"
    },
    "currency": "EUR"
  },
  "debtorName": "John Doe",
  "serviceLevel": "SEPA",
  "instructedAmount": {
    "currency": "EUR",
    "amount": "500"
  },
  "creditorAccount": {
    "identification": {
      "iban": "DE16195554277485442959"
    },
    "currency": "EUR"
  },
  "creditorAgent": {
    "institutionIdentification": {
      "bicfi": "DEUTDEFF"
    }
  },
  "creditorName": "Merchant123",
  "product": "SEPA_DIRECT_DEBIT",
  "direction": "INCOMING",
  "mandateRelatedInformation": {
    "mandateIdentification": "mandate-id",
    "dateOfSignature": "22-03-2020"
  },
  "paymentTypeInformation": {
    "sequenceType": "OOFF"
  },
  "creditorSchemeIdentification": {
    "identification": {
      "privateIdentification": "pr2432edax132131"
    }
  }
}

200 :
collectionStatusDetailsResponse

{
  "transactionStatus": "ACSC",
  "lastStatusUpdateTimestamp": "2019-03-15T09:34:00.000Z"
}

400 :
missingDetailsForCollectionId

{
  "tppMessages": [
    {
      "category": "ERROR",
      "code": "SERVICE_INVALID",
      "path": "collectionId",
      "text": "Unable to find collection details for collection 123"
    }
  ]
}

405 :
unsupportedHttpMethod

{
  "tppMessages": [
    {
      "category": "ERROR",
      "code": "SERVICE_INVALID",
      "text": "There was an error processing your request. It has been logged (ID a449ea6319107e42)."
    }
  ]
}

406 :
unsupportedAcceptType

{
  "tppMessages": [
    {
      "category": "ERROR",
      "code": "SERVICE_INVALID",
      "text": "There was an error processing your request. It has been logged (ID a449ea6319107e42)."
    }
  ]
}

500 :
internalServerError

{
  "tppMessages": [
    {
      "category": "ERROR",
      "code": "SERVICE_INVALID",
      "text": "There was an error processing your request. It has been logged (ID a449ea6319107e42)."
    }
  ]
}

Responses

Status Meaning Description Schema
200 OK OK - Collection Details were correctly found. CollectionDetails
400 Bad Request Bad Request - Validation error occurred. This code will cover malformed syntax in request or incorrect data in payload. FailedPaymentResponse
405 Method Not Allowed Method Not Allowed - This code is only sent when the HTTP method (PUT, POST, DELETE, GET etc.) is not supported on a specific endpoint. It has nothing to do with the consent, payment or account information data model. FailedPaymentResponse
406 Not Acceptable Not Acceptable - A media type which the serves does not support has been supplied. FailedPaymentResponse
500 Internal Server Error Internal Server Error - Internal server error occurred. FailedPaymentResponse
503 Service Unavailable Service Unavailable - The server is currently unavailable. Generally, this is a temporary state. None

manuallyRejectOutgoingCollection

POST /v1/collections/{collectionOrderId}:reject

Manually Reject an Outgoing Collection.

Parameters

Name Type Description In Required
collectionOrderId string none path true

Example Responses

400 :
invalidTransactionStatus

{
  "tppMessages": [
    {
      "category": "ERROR",
      "code": "INVALID_TRANSACTION_STATUS",
      "text": "Transaction has invalid status: TO_BE_REJECTED. Expected status is: TO_BE_SENT."
    }
  ]
}

500 :
internalServerError

{
  "tppMessages": [
    {
      "category": "ERROR",
      "code": "SERVICE_INVALID",
      "text": "There was an error processing your request. It has been logged (ID a449ea6319107e42)."
    }
  ]
}

Responses

Status Meaning Description Schema
200 OK OK - The specified collection order has been marked to be manually rejected. None
400 Bad Request Bad Request - Validation error occurred. This code will cover malformed syntax in request or incorrect data in payload. PaymentResponse
500 Internal Server Error Internal Server Error - Internal server error occurred. PaymentResponse
503 Service Unavailable Service Unavailable - The server is currently unavailable. Generally, this is a temporary state. None

Settings

These endpoints allow you to configure settings for the Payment Gateway such as setting callback URLs which will be notified on certain actions.

publishWebhook

POST /v1/gateway-webhook-url

This contract is for the webhook url configured under payment gateway. This will published outgoing SEPA instructions, like pacs.008, pacs.004, pacs.002 etc. via webhook call

Example Request

Parameters

Name Type Description In Required
Content-Type string application/xml header true
Authorization string BASIC authentication credentials Base64 encoded, if credentials filled in webhook configuration header false
Message-Type string Message namespace URN. For example urn:iso:std:iso:20022:tech:xsd:pacs.008.001.02 header true
Message-Id string Message ID, representing the GrpHdr>MsgId field of the message header true
body string(EPC) SEPA instruction body true

Responses

Status Meaning Description Schema

Schemas

AcceptStatusUpdateOnRecall

{
  "groupHeader": {
    "creationDateTime": "string",
    "instructingAgent": "string",
    "messageIdentification": "string"
  },
  "transactionInformation": {
    "originalInstructionIdentification": "string",
    "originalMessageIdentification": "string",
    "statusRequestIdentification": "string"
  }
}

Properties

Name Type Description Required Restrictions
groupHeader GroupHeaderIncoming Set of characteristics shared by all individual transactions included in the Request for Status Update on Recall message true none
transactionInformation TransactionInformation Information concerning the original transaction, to which the Request for Status Update on Recall message refers true none

Account

{
  "currency": "str",
  "identification": {
    "iban": "stringstringstr",
    "other": {
      "identification": "string",
      "scheme": "string"
    }
  }
}

Beneficiary’s account.

Properties

Name Type Description Required Restrictions
currency string ISO 4217 Alpha 3 currency code. false none
identification Identification Unique and unambiguous identification for the account. true none

AccountIdentificationsFilterCriteriaDTO

{
  "field": "SCHEME",
  "operator": "EQUALS",
  "value": "string"
}

Account identification search criteria

Properties

Name Type Description Required Restrictions
field string Contains the actual searching fields that can be native (one from the provided list) true none
operator string EQUALS - checks that 'field' equals to 'value' (strict equals, does not support parts or masks) true none
value string The value to match the searching criteria false none

Enumerated Values

Property Value
field SCHEME
field IBAN
field IDENTIFICATION
operator EQUALS

AccountIdentificationsSearchRequestDTO

{
  "filterCriteria": [
    {
      "field": "SCHEME",
      "operator": "EQUALS",
      "value": "string"
    }
  ]
}

Properties

Name Type Description Required Restrictions
filterCriteria [AccountIdentificationsFilterCriteriaDTO] Account identification search criteria true none

AccountIdentificationsSearchResponseDTO

{
  "accountId": "string",
  "currency": "string",
  "identification": {
    "iban": "stringstringstr",
    "other": {
      "identification": "string",
      "scheme": "string"
    }
  },
  "type": "string"
}

Properties

Name Type Description Required Restrictions
accountId string AccountID (Unique and unambiguous identification for the account.) true none
currency string Account currency false none
identification Identification Unique and unambiguous identification for the account. true none
type string Account type false none

AccountInternalIdentification

{
  "currency": "string",
  "id": "string",
  "type": "DEPOSIT"
}

Mambu Accounts corresponding to the current IBAN / proprietary identification

Properties

Name Type Description Required Restrictions
currency string none false none
id string none false none
type string none false none

Enumerated Values

Property Value
type DEPOSIT
type LOAN

AccountMappingResponse

{
  "internalAccounts": [
    {
      "currency": "string",
      "id": "string",
      "type": "DEPOSIT"
    }
  ],
  "tppMessages": [
    {
      "category": "ERROR",
      "code": "PARAMETER_NOT_SUPPORTED",
      "errorCode": "string",
      "errorReason": "string",
      "path": "string",
      "text": "string"
    }
  ]
}

Properties

Name Type Description Required Restrictions
internalAccounts [AccountInternalIdentification] Mambu Accounts corresponding to the current IBAN / proprietary identification false none
tppMessages [TPPMessage] Messages to the TPP on operational issues. false none

Address

{
  "buildingNumber": "string",
  "city": "string",
  "countryCode": "st",
  "postalCode": "string",
  "street": "string"
}

Properties

Name Type Description Required Restrictions
buildingNumber string none false none
city string none false none
countryCode string Two characters as defined by ISO 3166. true none
postalCode string none false none
street string none false none

Agent

{
  "institutionIdentification": {
    "bicfi": "stringst"
  }
}

Financial institution servicing an account for the creditor. This field is mandatory when proprietary ('other') creditor account identification is used.

Properties

Name Type Description Required Restrictions
institutionIdentification InstitutionIdentification Unique and unambiguous identification of a financial institution, as assigned under an internationally recognised identification scheme. true none

AmendmentInformationDetails

{
  "originalCreditorSchemeIdentification": {
    "identification": {
      "iban": "stringstringstr",
      "other": {
        "identification": "string",
        "scheme": "string"
      }
    },
    "name": "string"
  },
  "originalDebtorAccount": {
    "currency": "str",
    "identification": {
      "iban": "stringstringstr",
      "other": {
        "identification": "string",
        "scheme": "string"
      }
    }
  },
  "originalDebtorAgent": {
    "institutionIdentification": {
      "bicfi": "stringst"
    }
  },
  "originalMandateIdentification": "string"
}

List of mandate elements that have been modified.

Properties

Name Type Description Required Restrictions
originalCreditorSchemeIdentification OriginalCreditorSchemeIdentification Original creditor scheme identification that has been modified. false none
originalDebtorAccount Account Beneficiary’s account. false none
originalDebtorAgent Agent Financial institution servicing an account for the creditor. This field is mandatory when proprietary ('other') creditor account identification is used. false none
originalMandateIdentification string Unique identification, as assigned by the creditor, to unambiguously identify the original mandate. false none

AmlPaymentIdentification

{
  "transactionIdentification": "string"
}

Payment instruction reference.

Properties

Name Type Description Required Restrictions
transactionIdentification string Unique identification as assigned by the initiating party to be used as transaction identifier. true none

AmlResult

{
  "groupHeader": {
    "messageIdentification": "string"
  },
  "transactions": [
    {
      "debtorAgent": {
        "institutionIdentification": {
          "bicfi": "stringst"
        }
      },
      "interbankSettlementDate": "stringstri",
      "paymentIdentification": {
        "transactionIdentification": "string"
      },
      "status": "ACCEPTED"
    }
  ]
}

Properties

Name Type Description Required Restrictions
groupHeader GroupHeader GroupHeader information from the original instruction. true none
transactions [AmlTransactionResult] List of AML result checks, one per Payment Order. true none

AmlTransactionResult

{
  "debtorAgent": {
    "institutionIdentification": {
      "bicfi": "stringst"
    }
  },
  "interbankSettlementDate": "stringstri",
  "paymentIdentification": {
    "transactionIdentification": "string"
  },
  "status": "ACCEPTED"
}

List of AML result checks, one per Payment Order.

Properties

Name Type Description Required Restrictions
debtorAgent Agent Financial institution servicing an account for the creditor. This field is mandatory when proprietary ('other') creditor account identification is used. true none
interbankSettlementDate string InterbankSettlementDate from the original instruction. true none
paymentIdentification AmlPaymentIdentification Payment instruction reference. true none
status string Actual status of the AML investigation. Only
ACCEPTED, SUSPENDED, REJECTED, MANUAL_REDIRECT_EXTERNAL or MANUAL_REDIRECT_INTERNAL are allowed.
true none

Enumerated Values

Property Value
status ACCEPTED
status SUSPENDED
status REJECTED
status MANUAL_REDIRECT_EXTERNAL
status MANUAL_REDIRECT_INTERNAL

Amount

{
  "amount": "string",
  "currency": "str"
}

Transaction currency and amount.

Properties

Name Type Description Required Restrictions
amount string The amount given with fractional digits, where fractions must be compliant to the currency definition. Negative amounts are signed by minus. The decimal separator is a dot. true none
currency string ISO 4217 Alpha 3 currency code. true none

Assignment

{
  "creationDateTime": "2019-08-24T14:15:22Z",
  "identification": "string"
}

Assignment

Properties

Name Type Description Required Restrictions
creationDateTime string(date-time) creation date time false none
identification string camt.027/camt.087 assignment id false none

Collection

{
  "creditorAccount": {
    "currency": "str",
    "identification": {
      "iban": "stringstringstr",
      "other": {
        "identification": "string",
        "scheme": "string"
      }
    }
  },
  "creditorAddress": {
    "buildingNumber": "string",
    "city": "string",
    "countryCode": "st",
    "postalCode": "string",
    "street": "string"
  },
  "creditorAgent": {
    "institutionIdentification": {
      "bicfi": "stringst"
    }
  },
  "creditorIdentification": {
    "code": "stri",
    "issuer": "string",
    "privateIdentification": "string",
    "proprietary": "string"
  },
  "creditorName": "string",
  "creditorSchemeIdentification": {
    "identification": {
      "iban": "stringstringstr",
      "other": {
        "identification": "string",
        "scheme": "string"
      }
    }
  },
  "debtorAccount": {
    "currency": "str",
    "identification": {
      "iban": "stringstringstr",
      "other": {
        "identification": "string",
        "scheme": "string"
      }
    }
  },
  "debtorAddress": {
    "buildingNumber": "string",
    "city": "string",
    "countryCode": "st",
    "postalCode": "string",
    "street": "string"
  },
  "debtorAgent": {
    "institutionIdentification": {
      "bicfi": "stringst"
    }
  },
  "debtorIdentification": {
    "code": "stri",
    "issuer": "string",
    "privateIdentification": "string",
    "proprietary": "string"
  },
  "debtorName": "string",
  "instructedAmount": {
    "amount": "string",
    "currency": "str"
  },
  "localInstrument": "string",
  "mandateRelatedInformation": {
    "amendmentInformationDetails": {
      "originalCreditorSchemeIdentification": {
        "identification": {
          "iban": "stringstringstr",
          "other": {
            "identification": "string",
            "scheme": "string"
          }
        },
        "name": "string"
      },
      "originalDebtorAccount": {
        "currency": "str",
        "identification": {
          "iban": "stringstringstr",
          "other": {
            "identification": "string",
            "scheme": "string"
          }
        }
      },
      "originalDebtorAgent": {
        "institutionIdentification": {
          "bicfi": "stringst"
        }
      },
      "originalMandateIdentification": "string"
    },
    "dateOfSignature": "string",
    "mandateIdentification": "string"
  },
  "paymentIdentification": {
    "endToEndIdentification": "string",
    "transactionIdentification": "string"
  },
  "paymentTypeInformation": {
    "sequenceType": "string"
  },
  "purposeCode": "stri",
  "remittanceInformationStructured": {
    "reference": "string",
    "referenceIssuer": "string",
    "referenceType": "string"
  },
  "remittanceInformationUnstructured": "string",
  "requestedExecutionDate": "stringstri",
  "requestedExecutionTime": "stringstringstrin",
  "serviceLevel": "string",
  "ultimateCreditor": "string",
  "ultimateDebtor": "string"
}

Properties

Name Type Description Required Restrictions
creditorAccount Account Beneficiary’s account. true none
creditorAddress Address none false none
creditorAgent Agent Financial institution servicing an account for the creditor. This field is mandatory when proprietary ('other') creditor account identification is used. false none
creditorIdentification PartyIdentification Beneficiary’s identification. false none
creditorName string The Party whose account is credited with the payment. true none
creditorSchemeIdentification CreditorSchemeIdentification Credit party that signs the mandate. true none
debtorAccount Account Beneficiary’s account. true none
debtorAddress Address none false none
debtorAgent Agent Financial institution servicing an account for the creditor. This field is mandatory when proprietary ('other') creditor account identification is used. false none
debtorIdentification PartyIdentification Beneficiary’s identification. false none
debtorName string none true none
instructedAmount Amount Transaction currency and amount. true none
localInstrument string User community specific instrument. Used to specify a local instrument, local clearing option and/or further qualify the service or service level. false none
mandateRelatedInformation Mandate Set of elements used to provide further details of the direct debit mandate signed between the creditor and the debtor. true none
paymentIdentification PaymentIdentification Payment instruction reference. false none
paymentTypeInformation PaymentTypeInformation Set of elements used to further specify the type of transaction. true none
purposeCode string The PurposeCode value or a similar explanation is not added to the payer’s Electronic account statement. This value can be shown on both the payers and the beneficiary’s on the Camt.053 account statement. false none
remittanceInformationStructured Remittance Payment details. Structured message, one entry (max 140 characters XML tags and data included).
Alternatives for structured remittance
information, see examples:
- Reference number (note: facility to use ISO 11649, International standard of Reference information)
false none
remittanceInformationUnstructured string Payment details. Free text, one occurrence (max 140 characters).
Payment reason (according to current recurrent payment standard) can be given in this element.
false none
requestedExecutionDate string Debit date given by the customer. A particular point in the progression of time in a calendar year expressed in the YYYY-MM-DD format. false none
requestedExecutionTime string Debit date given by the customer. A particular point in the progression of time defined by a mandatory date and a mandatory time component, expressed in either UTC time format (YYYY-MM-DDThh:mm:ss.sssZ) or local time with UTC offset format (YYYY-MM-DDThh:mm:ss.sss+/-hh:mm). These representations are aligned with ISO 8601. false none
serviceLevel string Agreement under which or rules under which the transaction should be processed. Only SEPA is allowed. false none
ultimateCreditor string Party which is the ultimate beneficiary of the payment. For example, the payment can be credited to an account of a financing company, with the ultimate beneficiary being the customer of the financing company. false none
ultimateDebtor string The Party that originally ordered goods or services and to whom the seller has sent the invoice. Ultimate Debtor can be used when the acceptor of the invoice is different than the payer. false none

CollectionDetails

{
  "creditorAccount": {
    "currency": "str",
    "identification": {
      "iban": "stringstringstr",
      "other": {
        "identification": "string",
        "scheme": "string"
      }
    }
  },
  "creditorAddress": {
    "addressLine1": "string",
    "addressLine2": "string",
    "buildingNumber": "string",
    "city": "string",
    "countryCode": "string",
    "postalCode": "string",
    "street": "string"
  },
  "creditorAgent": {
    "institutionIdentification": {
      "bicfi": "stringst"
    }
  },
  "creditorName": "string",
  "creditorSchemeIdentification": {
    "identification": {
      "iban": "stringstringstr",
      "other": {
        "identification": "string",
        "scheme": "string"
      }
    }
  },
  "debtorAccount": {
    "currency": "str",
    "identification": {
      "iban": "stringstringstr",
      "other": {
        "identification": "string",
        "scheme": "string"
      }
    }
  },
  "debtorAddress": {
    "addressLine1": "string",
    "addressLine2": "string",
    "buildingNumber": "string",
    "city": "string",
    "countryCode": "string",
    "postalCode": "string",
    "street": "string"
  },
  "debtorAgent": {
    "institutionIdentification": {
      "bicfi": "stringst"
    }
  },
  "debtorName": "string",
  "direction": "string",
  "instructedAmount": {
    "amount": "string",
    "currency": "str"
  },
  "lastStatusUpdateTimestamp": "2019-08-24T14:15:22Z",
  "mandateRelatedInformation": {
    "amendmentInformationDetails": {
      "originalCreditorSchemeIdentification": {
        "identification": {
          "iban": "stringstringstr",
          "other": {
            "identification": "string",
            "scheme": "string"
          }
        },
        "name": "string"
      },
      "originalDebtorAccount": {
        "currency": "str",
        "identification": {
          "iban": "stringstringstr",
          "other": {
            "identification": "string",
            "scheme": "string"
          }
        }
      },
      "originalDebtorAgent": {
        "institutionIdentification": {
          "bicfi": "stringst"
        }
      },
      "originalMandateIdentification": "string"
    },
    "dateOfSignature": "string",
    "mandateIdentification": "string"
  },
  "paymentIdentification": {
    "endToEndIdentification": "string",
    "instructionIdentification": "string",
    "transactionIdentification": "string"
  },
  "paymentTypeInformation": {
    "sequenceType": "string"
  },
  "product": "SEPA_CREDIT_TRANSFER",
  "purposeCode": "string",
  "remittanceInformationStructured": {
    "reference": "string",
    "referenceIssuer": "string",
    "referenceType": "string"
  },
  "remittanceInformationUnstructured": "string",
  "requestedExecutionDate": "string",
  "requestedExecutionTime": "string",
  "serviceLevel": "string",
  "tppMessages": [
    {
      "category": "ERROR",
      "code": "PARAMETER_NOT_SUPPORTED",
      "errorCode": "string",
      "errorReason": "string",
      "path": "string",
      "text": "string"
    }
  ],
  "transactionStatus": "string",
  "ultimateCreditor": "string",
  "ultimateDebtor": "string"
}

Properties

Name Type Description Required Restrictions
creditorAccount Account Beneficiary’s account. false none
creditorAddress FullDetailsAddress none false none
creditorAgent Agent Financial institution servicing an account for the creditor. This field is mandatory when proprietary ('other') creditor account identification is used. false none
creditorName string The Party whose account is credited with the payment. false none
creditorSchemeIdentification CreditorSchemeIdentification Credit party that signs the mandate. false none
debtorAccount Account Beneficiary’s account. false none
debtorAddress FullDetailsAddress none false none
debtorAgent Agent Financial institution servicing an account for the creditor. This field is mandatory when proprietary ('other') creditor account identification is used. false none
debtorName string none false none
direction string Payment direction, as inferred based on current Payment Product, Debtor and Creditor Agents false none
instructedAmount Amount Transaction currency and amount. false none
lastStatusUpdateTimestamp string(date-time) Timestamp when the transaction status was last updated, expressed in UTC time format (YYYY-MM-DDThh:mm:ss.sssZ). The representation is aligned with ISO 8601. false none
mandateRelatedInformation Mandate Set of elements used to provide further details of the direct debit mandate signed between the creditor and the debtor. false none
paymentIdentification FullPaymentIdentification Payment instruction reference. false none
paymentTypeInformation PaymentTypeInformation Set of elements used to further specify the type of transaction. false none
product string Payment Product type false none
purposeCode string The PurposeCode value or a similar explanation is not added to the payer’s Electronic account statement. This value can be shown on both the payers and the beneficiary’s on the Camt.053 account statement. false none
remittanceInformationStructured Remittance Payment details. Structured message, one entry (max 140 characters XML tags and data included).
Alternatives for structured remittance
information, see examples:
- Reference number (note: facility to use ISO 11649, International standard of Reference information)
false none
remittanceInformationUnstructured string Payment details. Free text, one occurrence (max 140 characters).
Payment reason (according to current recurrent payment standard) can be given in this element.
false none
requestedExecutionDate string Debit date given by the customer. A particular point in the progression of time in a calendar year expressed in the YYYY-MM-DD format. false none
requestedExecutionTime string Debit date given by the customer. A particular point in the progression of time defined by a mandatory date and a mandatory time component, expressed in either UTC time format (YYYY-MM-DDThh:mm:ss.sssZ) or local time with UTC offset format (YYYY-MM-DDThh:mm:ss.sss+/-hh:mm). These representations are aligned with ISO 8601. false none
serviceLevel string none false none
tppMessages [TPPMessage] Messages to the TPP on operational issues. false none
transactionStatus string none true none
ultimateCreditor string Party which is the ultimate beneficiary of the payment. For example, the payment can be credited to an account of a financing company, with the ultimate beneficiary being the customer of the financing company. false none
ultimateDebtor string The Party that originally ordered goods or services and to whom the seller has sent the invoice. Ultimate Debtor can be used when the acceptor of the invoice is different than the payer. false none

Enumerated Values

Property Value
product SEPA_CREDIT_TRANSFER
product SEPA_DIRECT_DEBIT

CollectionResponse

{
  "collectionId": "string",
  "tppMessages": [
    {
      "category": "ERROR",
      "code": "PARAMETER_NOT_SUPPORTED",
      "errorCode": "string",
      "errorReason": "string",
      "path": "string",
      "text": "string"
    }
  ],
  "transactionFeeIndicator": true,
  "transactionStatus": "ACSC"
}

Properties

Name Type Description Required Restrictions
collectionId string Resource identification of the generated payment initiation resource. true none
tppMessages [TPPMessage] Messages to the TPP on operational issues. false none
transactionFeeIndicator boolean If equals "true", the transaction will involve transaction cost. false none
transactionStatus string PSD2 transaction status codes:
  • ACSC: Settlement on the debtor’s account has been completed.
    Usage: this can be used by the first agent to report to the debtor that the transaction has been completed.
    Warning: this status is provided for transaction status reasons, not for financial information. It can only be used after bilateral agreement.
  • ACSP: All preceding checks such as technical validation and customer profile were successful and therefore the payment initiation has been accepted for execution.
  • ACTC: Authentication and syntactical and semantical validation are successful.
  • RCVD: Payment initiation has been received by the receiving agent.
  • PDNG: Payment initiation or individual transaction included in the payment initiation is pending. Further checks and status update will be performed.
  • RJCT: Payment initiation or individual transaction included in the payment initiation has been rejected.
true none

Enumerated Values

Property Value
transactionStatus ACSC
transactionStatus ACSP
transactionStatus ACTC
transactionStatus RCVD
transactionStatus PDNG
transactionStatus RJCT

CreateAccountMapping

{
  "identification": {
    "iban": "stringstringstr",
    "other": {
      "identification": "string",
      "scheme": "string"
    }
  }
}

Properties

Name Type Description Required Restrictions
identification Identification Unique and unambiguous identification for the account. true none

CreateAccountMappings

{
  "accountIds": [
    "string"
  ],
  "identification": {
    "iban": "stringstringstr",
    "other": {
      "identification": "string",
      "scheme": "string"
    }
  }
}

Properties

Name Type Description Required Restrictions
accountIds [string] IDs of the Mambu Accounts which will be correlated to the IBAN or proprietary identification. The association will be made on account currency. true none
identification Identification Unique and unambiguous identification for the account. true none

CreateBlockingRule

{
  "creditorMandate": {
    "creditorSchemeIdentification": {
      "identification": {
        "iban": "stringstringstr",
        "other": {
          "identification": "string",
          "scheme": "string"
        }
      }
    },
    "mandateRelatedInformation": {
      "mandateIdentification": "string"
    }
  },
  "product": "string"
}

Properties

Name Type Description Required Restrictions
creditorMandate CreditorMandate Collection mandate identification for blocking rule deletion false none
product string Payment Product to which this rule applies. For now, blocking rules can be applied to SEPA_DIRECT_DEBIT only true none

CreditTransferTransactionInformation

{
  "_metadata": {
    "paymentId": "string",
    "returnReason": "string",
    "transactionSn": 0,
    "transactionStatus": "string"
  },
  "additionalProperties": null
}

Provides information on the individual transaction(s) included in the message

Properties

Name Type Description Required Restrictions
_metadata SepaInstructionMetadata Instruction-level metadata of a SEPA instruction false none
additionalProperties any cdtTrfTxInf information included in the message, as provided by the originator false none

CreditorMandate

{
  "creditorSchemeIdentification": {
    "identification": {
      "iban": "stringstringstr",
      "other": {
        "identification": "string",
        "scheme": "string"
      }
    }
  },
  "mandateRelatedInformation": {
    "mandateIdentification": "string"
  }
}

Collection mandate identification for blocking rule deletion

Properties

Name Type Description Required Restrictions
creditorSchemeIdentification CreditorSchemeIdentification Credit party that signs the mandate. true none
mandateRelatedInformation MandateRelatedInformation none true none

CreditorSchemeIdentification

{
  "identification": {
    "iban": "stringstringstr",
    "other": {
      "identification": "string",
      "scheme": "string"
    }
  }
}

Credit party that signs the mandate.

Properties

Name Type Description Required Restrictions
identification Identification Unique and unambiguous identification for the account. true none

DeleteBlockingRule

{
  "creditorMandate": {
    "creditorSchemeIdentification": {
      "identification": {
        "iban": "stringstringstr",
        "other": {
          "identification": "string",
          "scheme": "string"
        }
      }
    },
    "mandateRelatedInformation": {
      "mandateIdentification": "string"
    }
  },
  "product": "string"
}

Properties

Name Type Description Required Restrictions
creditorMandate CreditorMandate Collection mandate identification for blocking rule deletion false none
product string Payment Product for blocking rule deletion true none

FIToFICstmrCdtTrf

{
  "_metadata": {
    "bulkSn": 0,
    "direction": "string",
    "procstatus": "string",
    "transactions": 0
  },
  "cdtTrfTxInf": [
    {
      "_metadata": {
        "paymentId": "string",
        "returnReason": "string",
        "transactionSn": 0,
        "transactionStatus": "string"
      },
      "additionalProperties": null
    }
  ],
  "grpHdr": {}
}

FI to FI Customer Credit Transfer

Properties

Name Type Description Required Restrictions
_metadata SepaMessageMetadata Message-level metadata of the current SEPA message false none
cdtTrfTxInf [CreditTransferTransactionInformation] [Provides information on the individual transaction(s) included in the message] false none
grpHdr object Set of characteristics shared by all individual transactions included in the message, as provided by the originator false none

FailedAccountMappingResponse

{
  "tppMessages": [
    {
      "category": "ERROR",
      "code": "PARAMETER_NOT_SUPPORTED",
      "errorCode": "string",
      "errorReason": "string",
      "path": "string",
      "text": "string"
    }
  ]
}

Properties

Name Type Description Required Restrictions
tppMessages [TPPMessage] Messages to the TPP on operational issues. true none

FailedPaymentResponse

{
  "tppMessages": [
    {
      "category": "ERROR",
      "code": "PARAMETER_NOT_SUPPORTED",
      "errorCode": "string",
      "errorReason": "string",
      "path": "string",
      "text": "string"
    }
  ]
}

Properties

Name Type Description Required Restrictions
tppMessages [TPPMessage] Messages to the TPP on operational issues. true none

FullDetailsAddress

{
  "addressLine1": "string",
  "addressLine2": "string",
  "buildingNumber": "string",
  "city": "string",
  "countryCode": "string",
  "postalCode": "string",
  "street": "string"
}

Properties

Name Type Description Required Restrictions
addressLine1 string none false none
addressLine2 string none false none
buildingNumber string none false none
city string none false none
countryCode string none false none
postalCode string none false none
street string none false none

FullPaymentIdentification

{
  "endToEndIdentification": "string",
  "instructionIdentification": "string",
  "transactionIdentification": "string"
}

Payment instruction reference.

Properties

Name Type Description Required Restrictions
endToEndIdentification string Unique identification assigned by the payer to identify the transaction. This identification will be returned to the payer and passed on to the beneficiary. false none
instructionIdentification string Unique identification as assigned by an instructing party for an instructed party to unambiguously identify the instruction. false none
transactionIdentification string Unique identification as assigned by the initiating party to be used as transaction identifier. If left empty, Mambu transaction id will be used. false none

GroupHeader

{
  "messageIdentification": "string"
}

GroupHeader information from the original instruction.

Properties

Name Type Description Required Restrictions
messageIdentification string Message Identification from the original instruction. true none

GroupHeaderIncoming

{
  "creationDateTime": "string",
  "instructingAgent": "string",
  "messageIdentification": "string"
}

Set of characteristics shared by all individual transactions included in the Request for Status Update on Recall message

Properties

Name Type Description Required Restrictions
creationDateTime string Date and time at which the inquiry message was created. Accepted format: yyyy-MM-ddTHH:mm:ss true none
instructingAgent string Agent that is instructed by the previous party in the chain to carry out the (set of) instruction(s). true none
messageIdentification string Message identification to identify the inquiry message true none

Identification

{
  "iban": "stringstringstr",
  "other": {
    "identification": "string",
    "scheme": "string"
  }
}

Unique and unambiguous identification for the account.

Properties

Name Type Description Required Restrictions
iban string ISO 13616 International Bank Account Number (IBAN) - identifier used internationally by financial institutions to uniquely identify the account of a customer. false none
other Other Unique identification of an account, as assigned by the account servicer, using other identification scheme. false none

IdentificationsToMask

{
  "identifications": [
    {
      "iban": "stringstringstr",
      "other": {
        "identification": "string",
        "scheme": "string"
      }
    }
  ]
}

Properties

Name Type Description Required Restrictions
identifications [Identification] [Unique and unambiguous identification for the account.] true none

IncomingMessageResponse

{
  "messageId": "string",
  "messageType": "string"
}

Properties

Name Type Description Required Restrictions
messageId string Resource identification of the incoming message true none
messageType string URN namespace of the incoming message true none

IncomingPaymentResponse

{
  "messageId": "string",
  "messageType": "string"
}

Properties

Name Type Description Required Restrictions
messageId string Resource identification of the incoming message true none
messageType string URN namespace of the incoming message true none

InstitutionIdentification

{
  "bicfi": "stringst"
}

Unique and unambiguous identification of a financial institution, as assigned under an internationally recognised identification scheme.

Properties

Name Type Description Required Restrictions
bicfi string ISO 9362 Business identifier code (BIC) - code allocated to a financial institution. true none

Mandate

{
  "amendmentInformationDetails": {
    "originalCreditorSchemeIdentification": {
      "identification": {
        "iban": "stringstringstr",
        "other": {
          "identification": "string",
          "scheme": "string"
        }
      },
      "name": "string"
    },
    "originalDebtorAccount": {
      "currency": "str",
      "identification": {
        "iban": "stringstringstr",
        "other": {
          "identification": "string",
          "scheme": "string"
        }
      }
    },
    "originalDebtorAgent": {
      "institutionIdentification": {
        "bicfi": "stringst"
      }
    },
    "originalMandateIdentification": "string"
  },
  "dateOfSignature": "string",
  "mandateIdentification": "string"
}

Set of elements used to provide further details of the direct debit mandate signed between the creditor and the debtor.

Properties

Name Type Description Required Restrictions
amendmentInformationDetails AmendmentInformationDetails List of mandate elements that have been modified. false none
dateOfSignature string Date on which the direct debit mandate has been signed by the debtor. true none
mandateIdentification string Unique identification, as assigned by the creditor, to unambiguously identify the mandate. true none

MandateRelatedInformation

{
  "mandateIdentification": "string"
}

Properties

Name Type Description Required Restrictions
mandateIdentification string Unique identification, as assigned by the creditor, to unambiguously identify the collection mandate. true none

Message

{}

List of SEPA instructions.

Properties

None

OriginalCamt056Data

{
  "cancellationIdentification": "string",
  "groupHeader": {
    "messageIdentification": "string"
  },
  "historicCancellationRequest": "string"
}

Properties

Name Type Description Required Restrictions
cancellationIdentification string Cancellation identification. true none
groupHeader GroupHeader GroupHeader information from the original instruction. false none
historicCancellationRequest string Original camt.056.001.01 message body XML for historical requests. false none

OriginalCreditorSchemeIdentification

{
  "identification": {
    "iban": "stringstringstr",
    "other": {
      "identification": "string",
      "scheme": "string"
    }
  },
  "name": "string"
}

Original creditor scheme identification that has been modified.

Properties

Name Type Description Required Restrictions
identification Identification Unique and unambiguous identification for the account. false none
name string Name of the Creditor. false none

OriginalInquiryData

{
  "assignment": {
    "creationDateTime": "2019-08-24T14:15:22Z",
    "identification": "string"
  },
  "caseIdentification": "string",
  "historicClaimRequest": "string",
  "messageTypeName": "PACS_002_001_03"
}

Properties

Name Type Description Required Restrictions
assignment Assignment Assignment false none
caseIdentification string camt.027/camt.087 case id true none
historicClaimRequest string Optional historic camt.087 or camt.027 xml false none
messageTypeName string messageTypeName true none

Enumerated Values

Property Value
messageTypeName PACS_002_001_03
messageTypeName PACS_003_001_02
messageTypeName PACS_004_001_02
messageTypeName PACS_007_001_02
messageTypeName PACS_008_001_02
messageTypeName PACS_028_001_01
messageTypeName CAMT_027_001_06
messageTypeName CAMT_029_001_03
messageTypeName CAMT_029_001_08
messageTypeName CAMT_056_001_01
messageTypeName CAMT_087_001_05
messageTypeName MT
messageTypeName UNKNOWN

OriginalPacs008Data

{
  "claimedValueDate": "2019-08-24",
  "groupHeader": {
    "messageIdentification": "string",
    "settlementDate": "2019-08-24"
  },
  "historicCreditTransferRequest": "string",
  "paymentIdentification": {
    "endToEndIdentification": "string",
    "transactionIdentification": "string"
  }
}

Properties

Name Type Description Required Restrictions
claimedValueDate string(date) Claimed value-date for change. false none
groupHeader Pacs008GroupHeader Original pacs.008.001.02 group header information. false none
historicCreditTransferRequest string Original pacs.008.001.02 message body XML for historical requests. false none
paymentIdentification PaymentIdentification Payment instruction reference. true none

Other

{
  "identification": "string",
  "scheme": "string"
}

Unique identification of an account, as assigned by the account servicer, using other identification scheme.

Properties

Name Type Description Required Restrictions
identification string Identification assigned by an institution. true none
scheme string Name of the identification scheme. true none

Pacs008GroupHeader

{
  "messageIdentification": "string",
  "settlementDate": "2019-08-24"
}

Original pacs.008.001.02 group header information.

Properties

Name Type Description Required Restrictions
messageIdentification string Original message identification. true none
settlementDate string(date) Original settlement date. false none

PartyIdentification

{
  "code": "stri",
  "issuer": "string",
  "privateIdentification": "string",
  "proprietary": "string"
}

Beneficiary’s identification.

Properties

Name Type Description Required Restrictions
code string none false none
issuer string none false none
privateIdentification string Unique and unambiguous identification of a person, eg, passport. true none
proprietary string none false none

Payment

{
  "creditorAccount": {
    "currency": "str",
    "identification": {
      "iban": "stringstringstr",
      "other": {
        "identification": "string",
        "scheme": "string"
      }
    }
  },
  "creditorAddress": {
    "buildingNumber": "string",
    "city": "string",
    "countryCode": "st",
    "postalCode": "string",
    "street": "string"
  },
  "creditorAgent": {
    "institutionIdentification": {
      "bicfi": "stringst"
    }
  },
  "creditorIdentification": {
    "code": "stri",
    "issuer": "string",
    "privateIdentification": "string",
    "proprietary": "string"
  },
  "creditorName": "string",
  "debtorAccount": {
    "currency": "str",
    "identification": {
      "iban": "stringstringstr",
      "other": {
        "identification": "string",
        "scheme": "string"
      }
    }
  },
  "debtorAddress": {
    "buildingNumber": "string",
    "city": "string",
    "countryCode": "st",
    "postalCode": "string",
    "street": "string"
  },
  "debtorAgent": {
    "institutionIdentification": {
      "bicfi": "stringst"
    }
  },
  "debtorIdentification": {
    "code": "stri",
    "issuer": "string",
    "privateIdentification": "string",
    "proprietary": "string"
  },
  "debtorName": "string",
  "instructedAmount": {
    "amount": "string",
    "currency": "str"
  },
  "localInstrument": "string",
  "paymentIdentification": {
    "endToEndIdentification": "string",
    "transactionIdentification": "string"
  },
  "purposeCode": "stri",
  "remittanceInformationStructured": {
    "reference": "string",
    "referenceIssuer": "string",
    "referenceType": "string"
  },
  "remittanceInformationUnstructured": "string",
  "requestedExecutionDate": "stringstri",
  "requestedExecutionTime": "stringstringstrin",
  "serviceLevel": "string",
  "ultimateCreditor": "string",
  "ultimateDebtor": "string"
}

Properties

Name Type Description Required Restrictions
creditorAccount Account Beneficiary’s account. true none
creditorAddress Address none false none
creditorAgent Agent Financial institution servicing an account for the creditor. This field is mandatory when proprietary ('other') creditor account identification is used. false none
creditorIdentification PartyIdentification Beneficiary’s identification. false none
creditorName string The Party whose account is credited with the payment. true none
debtorAccount Account Beneficiary’s account. true none
debtorAddress Address none false none
debtorAgent Agent Financial institution servicing an account for the creditor. This field is mandatory when proprietary ('other') creditor account identification is used. false none
debtorIdentification PartyIdentification Beneficiary’s identification. false none
debtorName string none true none
instructedAmount Amount Transaction currency and amount. true none
localInstrument string User community specific instrument. Used to specify a local instrument, local clearing option and/or further qualify the service or service level. false none
paymentIdentification PaymentIdentification Payment instruction reference. false none
purposeCode string The PurposeCode value or a similar explanation is not added to the payer’s Electronic account statement. This value can be shown on both the payers and the beneficiary’s on the Camt.053 account statement. false none
remittanceInformationStructured Remittance Payment details. Structured message, one entry (max 140 characters XML tags and data included).
Alternatives for structured remittance
information, see examples:
- Reference number (note: facility to use ISO 11649, International standard of Reference information)
false none
remittanceInformationUnstructured string Payment details. Free text, one occurrence (max 140 characters).
Payment reason (according to current recurrent payment standard) can be given in this element.
false none
requestedExecutionDate string Debit date given by the customer. A particular point in the progression of time in a calendar year expressed in the YYYY-MM-DD format. false none
requestedExecutionTime string Debit date given by the customer. A particular point in the progression of time defined by a mandatory date and a mandatory time component, expressed in either UTC time format (YYYY-MM-DDThh:mm:ss.sssZ) or local time with UTC offset format (YYYY-MM-DDThh:mm:ss.sss+/-hh:mm). These representations are aligned with ISO 8601. false none
serviceLevel string Agreement under which or rules under which the transaction should be processed. Only SEPA is allowed. false none
ultimateCreditor string Party which is the ultimate beneficiary of the payment. For example, the payment can be credited to an account of a financing company, with the ultimate beneficiary being the customer of the financing company. false none
ultimateDebtor string The Party that originally ordered goods or services and to whom the seller has sent the invoice. Ultimate Debtor can be used when the acceptor of the invoice is different than the payer. false none

PaymentDetails

{
  "creditorAccount": {
    "currency": "str",
    "identification": {
      "iban": "stringstringstr",
      "other": {
        "identification": "string",
        "scheme": "string"
      }
    }
  },
  "creditorAddress": {
    "addressLine1": "string",
    "addressLine2": "string",
    "buildingNumber": "string",
    "city": "string",
    "countryCode": "string",
    "postalCode": "string",
    "street": "string"
  },
  "creditorAgent": {
    "institutionIdentification": {
      "bicfi": "stringst"
    }
  },
  "creditorName": "string",
  "debtorAccount": {
    "currency": "str",
    "identification": {
      "iban": "stringstringstr",
      "other": {
        "identification": "string",
        "scheme": "string"
      }
    }
  },
  "debtorAddress": {
    "addressLine1": "string",
    "addressLine2": "string",
    "buildingNumber": "string",
    "city": "string",
    "countryCode": "string",
    "postalCode": "string",
    "street": "string"
  },
  "debtorAgent": {
    "institutionIdentification": {
      "bicfi": "stringst"
    }
  },
  "debtorName": "string",
  "direction": "string",
  "instructedAmount": {
    "amount": "string",
    "currency": "str"
  },
  "lastStatusUpdateTimestamp": "2019-08-24T14:15:22Z",
  "paymentIdentification": {
    "endToEndIdentification": "string",
    "instructionIdentification": "string",
    "transactionIdentification": "string"
  },
  "product": "SEPA_CREDIT_TRANSFER",
  "purposeCode": "string",
  "remittanceInformationStructured": {
    "reference": "string",
    "referenceIssuer": "string",
    "referenceType": "string"
  },
  "remittanceInformationUnstructured": "string",
  "requestedExecutionDate": "string",
  "requestedExecutionTime": "string",
  "serviceLevel": "string",
  "tppMessages": [
    {
      "category": "ERROR",
      "code": "PARAMETER_NOT_SUPPORTED",
      "errorCode": "string",
      "errorReason": "string",
      "path": "string",
      "text": "string"
    }
  ],
  "transactionStatus": "string",
  "ultimateCreditor": "string",
  "ultimateDebtor": "string"
}

Properties

Name Type Description Required Restrictions
creditorAccount Account Beneficiary’s account. false none
creditorAddress FullDetailsAddress none false none
creditorAgent Agent Financial institution servicing an account for the creditor. This field is mandatory when proprietary ('other') creditor account identification is used. false none
creditorName string The Party whose account is credited with the payment. false none
debtorAccount Account Beneficiary’s account. false none
debtorAddress FullDetailsAddress none false none
debtorAgent Agent Financial institution servicing an account for the creditor. This field is mandatory when proprietary ('other') creditor account identification is used. false none
debtorName string none false none
direction string Payment direction, as inferred based on current Payment Product, Debtor and Creditor Agents false none
instructedAmount Amount Transaction currency and amount. false none
lastStatusUpdateTimestamp string(date-time) Timestamp when the transaction status was last updated, expressed in UTC time format (YYYY-MM-DDThh:mm:ss.sssZ). The representation is aligned with ISO 8601. false none
paymentIdentification FullPaymentIdentification Payment instruction reference. false none
product string Payment Product type false none
purposeCode string The PurposeCode value or a similar explanation is not added to the payer’s Electronic account statement. This value can be shown on both the payers and the beneficiary’s on the Camt.053 account statement. false none
remittanceInformationStructured Remittance Payment details. Structured message, one entry (max 140 characters XML tags and data included).
Alternatives for structured remittance
information, see examples:
- Reference number (note: facility to use ISO 11649, International standard of Reference information)
false none
remittanceInformationUnstructured string Payment details. Free text, one occurrence (max 140 characters).
Payment reason (according to current recurrent payment standard) can be given in this element.
false none
requestedExecutionDate string Debit date given by the customer. A particular point in the progression of time in a calendar year expressed in the YYYY-MM-DD format. false none
requestedExecutionTime string Debit date given by the customer. A particular point in the progression of time defined by a mandatory date and a mandatory time component, expressed in either UTC time format (YYYY-MM-DDThh:mm:ss.sssZ) or local time with UTC offset format (YYYY-MM-DDThh:mm:ss.sss+/-hh:mm). These representations are aligned with ISO 8601. false none
serviceLevel string none false none
tppMessages [TPPMessage] Messages to the TPP on operational issues. false none
transactionStatus string none true none
ultimateCreditor string Party which is the ultimate beneficiary of the payment. For example, the payment can be credited to an account of a financing company, with the ultimate beneficiary being the customer of the financing company. false none
ultimateDebtor string The Party that originally ordered goods or services and to whom the seller has sent the invoice. Ultimate Debtor can be used when the acceptor of the invoice is different than the payer. false none

Enumerated Values

Property Value
product SEPA_CREDIT_TRANSFER
product SEPA_DIRECT_DEBIT

PaymentIdentification

{
  "endToEndIdentification": "string",
  "transactionIdentification": "string"
}

Payment instruction reference.

Properties

Name Type Description Required Restrictions
endToEndIdentification string Unique identification assigned by the payer to identify the transaction. This identification will be returned to the payer and passed on to the beneficiary. false none
transactionIdentification string Unique identification as assigned by the initiating party to be used as transaction identifier. If left empty, Mambu transaction id will be used. false none

PaymentResponse

{
  "paymentId": "string",
  "tppMessages": [
    {
      "category": "ERROR",
      "code": "PARAMETER_NOT_SUPPORTED",
      "errorCode": "string",
      "errorReason": "string",
      "path": "string",
      "text": "string"
    }
  ],
  "transactionFeeIndicator": true,
  "transactionStatus": "ACSC"
}

Properties

Name Type Description Required Restrictions
paymentId string Resource identification of the generated payment initiation resource. true none
tppMessages [TPPMessage] Messages to the TPP on operational issues. false none
transactionFeeIndicator boolean If equals "true", the transaction will involve transaction cost. false none
transactionStatus string PSD2 transaction status codes:
  • ACSC: Settlement on the debtor’s account has been completed.
    Usage: this can be used by the first agent to report to the debtor that the transaction has been completed.
    Warning: this status is provided for transaction status reasons, not for financial information. It can only be used after bilateral agreement.
  • ACSP: All preceding checks such as technical validation and customer profile were successful and therefore the payment initiation has been accepted for execution.
  • ACTC: Authentication and syntactical and semantical validation are successful.
  • RCVD: Payment initiation has been received by the receiving agent.
  • PDNG: Payment initiation or individual transaction included in the payment initiation is pending. Further checks and status update will be performed.
  • RJCT: Payment initiation or individual transaction included in the payment initiation has been rejected.
true none

Enumerated Values

Property Value
transactionStatus ACSC
transactionStatus ACSP
transactionStatus ACTC
transactionStatus RCVD
transactionStatus PDNG
transactionStatus RJCT

PaymentTransactionInformation

{
  "_metadata": {
    "paymentId": "string",
    "returnReason": "string",
    "transactionSn": 0,
    "transactionStatus": "string"
  },
  "additionalProperties": null
}

Provides information on the individual transaction(s) included in the message

Properties

Name Type Description Required Restrictions
_metadata SepaInstructionMetadata Instruction-level metadata of a SEPA instruction false none
additionalProperties any txInf information included in the message, as provided by the originator false none

PaymentTypeInformation

{
  "sequenceType": "string"
}

Set of elements used to further specify the type of transaction.

Properties

Name Type Description Required Restrictions
sequenceType string Identifies the direct debit sequence, such as first, recurrent, final or one-off (FRST, RCUR, FNAL, OOFF). true none

PmtRtr

{
  "_metadata": {
    "bulkSn": 0,
    "direction": "string",
    "procstatus": "string",
    "transactions": 0
  },
  "grpHdr": {},
  "txInf": [
    {
      "_metadata": {
        "paymentId": "string",
        "returnReason": "string",
        "transactionSn": 0,
        "transactionStatus": "string"
      },
      "additionalProperties": null
    }
  ]
}

Payment Return

Properties

Name Type Description Required Restrictions
_metadata SepaMessageMetadata Message-level metadata of the current SEPA message false none
grpHdr object Set of characteristics shared by all individual transactions included in the message, as provided by the originator false none
txInf [PaymentTransactionInformation] [Provides information on the individual transaction(s) included in the message] false none

Refund

{
  "reasonCode": "MD01"
}

Properties

Name Type Description Required Restrictions
reasonCode string Reason for an interbank Refund, as defined in the SEPA guideline true none

Enumerated Values

Property Value
reasonCode MD01
reasonCode MD06

RefundReason

{
  "reasonCode": "MD01"
}

Properties

Name Type Description Required Restrictions
reasonCode string Reason for an interbank Refund, as defined in the SEPA guideline true none

Enumerated Values

Property Value
reasonCode MD01
reasonCode MD06

RefundStatus

{
  "correlationId": "string",
  "status": "SUCCESS",
  "tppMessages": [
    {
      "category": "ERROR",
      "code": "PARAMETER_NOT_SUPPORTED",
      "errorCode": "string",
      "errorReason": "string",
      "path": "string",
      "text": "string"
    }
  ]
}

Properties

Name Type Description Required Restrictions
correlationId string ID used to correlate between a request and its asynchronous response true none
status string Status of the Refund processing. SUCCESS if the refund was properly processed and published towards ACH, FAILURE otherwise true none
tppMessages [TPPMessage] Messages to the TPP on operational issues. false none

Enumerated Values

Property Value
status SUCCESS
status FAILURE

Remittance

{
  "reference": "string",
  "referenceIssuer": "string",
  "referenceType": "string"
}

Payment details. Structured message, one entry (max 140 characters XML tags and data included). Alternatives for structured remittance information, see examples:

Properties

Name Type Description Required Restrictions
reference string The actual reference. true none
referenceIssuer string none false none
referenceType string none false none

RequestAccepted

{
  "correlationId": "string"
}

Properties

Name Type Description Required Restrictions
correlationId string ID used to correlate between a request and its asynchronous response true none

RetryInformation

{
  "retryCount": 0,
  "retryUntil": "2019-08-24T14:15:22Z"
}

Collection retry information.

Properties

Name Type Description Required Restrictions
retryCount integer(int32) Number of retry attempts. false none
retryUntil string(date-time) Date until Direct Debit retry will be attempted. false none

Reverse

{
  "reasonCode": "AM05"
}

Properties

Name Type Description Required Restrictions
reasonCode string Reason for an interbank Reversal, as defined in the SEPA guideline true none

Enumerated Values

Property Value
reasonCode AM05
reasonCode MS02
reasonCode MS03

ReverseReason

{
  "reasonCode": "AM05"
}

Properties

Name Type Description Required Restrictions
reasonCode string Reason for an interbank Reverse, as defined in the SEPA guideline true none

Enumerated Values

Property Value
reasonCode AM05
reasonCode MS02
reasonCode MS03

SepaInstructionMetadata

{
  "paymentId": "string",
  "returnReason": "string",
  "transactionSn": 0,
  "transactionStatus": "string"
}

Instruction-level metadata of a SEPA instruction

Properties

Name Type Description Required Restrictions
paymentId string Resource identification of the generated payment initiation resource for the undelining instruction. Four outgoing messages this will contain the value of paymentId field returned in the Payment Initiation API. For incoming messages, this field will be populated once the message is picked up by the incoming scheduler. For incoming pacs.008 will contain an internal identification for the incoming payment order, for incoming pacs.004 the original payment order which is returned. false none
returnReason string Reason code for which this transaction was returned false none
transactionSn integer Instruction ID, as assigned by the Payment Gateway false none
transactionStatus string Status of the current transaction false none

SepaMessageFilter

{
  "dateFrom": "string",
  "dateTo": "string",
  "direction": "string",
  "limit": 1,
  "messageId": "string",
  "messageType": "string",
  "network": "string",
  "offset": 0
}

Properties

Name Type Description Required Restrictions
dateFrom string Start date from which the messages should be filtered. Accepted format: yyyy-MM-dd false none
dateTo string End date up until which the messages should be filtered. Accepted format: yyyy-MM-dd false none
direction string Message Direction. Supported values are I (incoming) or O (outgoing) true none
limit integer(int32) Limit of the number of objects returned by the server. Defaults to 20. false none
messageId string Message ID, representing the GrpHdr>>MsgId field of the message false none
messageType string Message type. Accepted values are pacs.008 and pacs.004 false none
network string Network for which the instructions should be received. SEPA is the only value allowed true none
offset integer(int32) Offset from which the results should be provided. Defaults to 0. false none

SepaMessageMetadata

{
  "bulkSn": 0,
  "direction": "string",
  "procstatus": "string",
  "transactions": 0
}

Message-level metadata of the current SEPA message

Properties

Name Type Description Required Restrictions
bulkSn integer Bulk ID of the SEPA message, as assigned by the Payment Gateway false none
direction string Direction of the SEPA message. I (incoming) or O (outgoing) false none
procstatus string Processing status of the SEPA message false none
transactions integer Number of transactions in the SEPA message false none

SepaMessages

{
  "instructions": [
    {}
  ],
  "tppMessages": [
    {
      "category": "ERROR",
      "code": "PARAMETER_NOT_SUPPORTED",
      "errorCode": "string",
      "errorReason": "string",
      "path": "string",
      "text": "string"
    }
  ]
}

Properties

Name Type Description Required Restrictions
instructions [Message] List of SEPA instructions. false none
tppMessages [TPPMessage] Messages to the TPP on operational issues. false none

TPPMessage

{
  "category": "ERROR",
  "code": "PARAMETER_NOT_SUPPORTED",
  "errorCode": "string",
  "errorReason": "string",
  "path": "string",
  "text": "string"
}

Messages to the TPP on operational issues.

Properties

Name Type Description Required Restrictions
category string Category designates the message severity. true none
code string Message error codes:
  • PARAMETER_NOT_SUPPORTED: The parameter is not supported by the API.
  • FORMAT_ERROR: Format of certain request fields are not matching the API requirements. An explicit path to the corresponding field might be added in the return message.
  • SERVICE_INVALID: The addressed service is not valid for the addressed resources or the submitted data.
  • PAYMENT_FAILED: The payment initiation POST request failed during the initial process.
true none
errorCode string Payment error code. Gives a more detailed analysis of any problems which may have occurred during the payment processing. false none
errorReason string Payment error reason. Gives a more detailed analysis of any problems which may have occurred during the payment processing. false none
path string none false none
text string Additional explaining text. false none

Enumerated Values

Property Value
category ERROR
category WARN
code PARAMETER_NOT_SUPPORTED
code FORMAT_ERROR
code SERVICE_INVALID
code PAYMENT_FAILED

TransactionInformation

{
  "originalInstructionIdentification": "string",
  "originalMessageIdentification": "string",
  "statusRequestIdentification": "string"
}

Information concerning the original transaction, to which the Request for Status Update on Recall message refers

Properties

Name Type Description Required Restrictions
originalInstructionIdentification string Unique identification, as assigned by the original instructing party for the original instructed party, to unambiguously identify the original instruction. true none
originalMessageIdentification string Point to point reference assigned by the original instructing party to identify the original group of individual transactions true none
statusRequestIdentification string Unique identification, as assigned by an instructing party for an instructed party, to identify the status request true none