Welcome

This documentation was last updated on Mon Oct 4 17:01:41 CEST 2021 and covers Version v1.36.2

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.

getMapping

GET /v1/accounts/{accountId}/identifications

Gets associations of an external account identification (IBAN or proprietary) to a Mambu Account.

Parameters

Name	Type	Description	In	Required
Content-Type	string	application/json	header	true
accountId	string	none	path	true
limit	integer(int32)	Limit the number of identifications retrieved. The default limit is 50, can be specified up to 1000.	query	false
offset	integer(int64)	Offset determines how many records will be skipped before being included in the returned results. The default offset value is 0.	query	false

Example Responses

200 :
Identification

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

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 existing external identifications.	Inline
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	[Identification]	[Unique and unambiguous identification for the account.]	false	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

Response Headers

Status	Header	Type	Format	Description
200	Items-Offset	undefined		The index of the first returned item.
200	Items-Limit	undefined		The requested page size.
200	Items-Total	undefined		The total count of available items.

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

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

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

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.

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

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

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

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:

• Reference number (note: facility to use ISO 11649, International standard of Reference information)

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