SEPA Gateway API provides an access to the SEPA compliant messaging systems, offering the simplified (yet fully functional) JSON message format instead of ISO 20022 XMLs.
The JSON API abstracts away most of the low level technical details like message IDs and duplicated reference data. This approach allows to simplify integration and significantly reduce the amount of data being transferred over the wire.
Provide your username and password for SASL/PLAIN
Provide your username and password for SASL/PLAIN
Message queue to send messages to
Allows to create a new outgoing payment.
Available only on servers:
Accepts the following message:
Contains details of outgoing payment creation request
{
"messageType": "OutgoingPaymentMessage",
"data": [
{
"wbUid": "string",
"msgId": "string",
"txId": "string",
"endToEndId": "string",
"paymentDate": "2019-11-21T16:32:59",
"debtor": {
"person": {
"type": "ORG",
"name": "string",
"id": "string",
"countryCode": "LT",
"fullAddress": "string",
"address": {
"streetName": "string",
"buildingNumber": "string",
"buildingName": "string",
"floor": "string",
"postBox": "string",
"room": "string",
"postCode": "string",
"townName": "string",
"townLocationName": "string",
"districtName": "string",
"countrySubDivision": "string",
"country": "LT"
},
"identityType": "ANY_BIC"
},
"account": {
"iban": "LT121000011101001000",
"bic": "TESTLT21",
"proxy": {
"id": "string",
"proxyType": {
"code": "stri",
"proprietary": "string"
}
}
}
},
"client": {
"person": {
"type": "ORG",
"name": "string",
"id": "string",
"countryCode": "LT",
"fullAddress": "string",
"address": {
"streetName": "string",
"buildingNumber": "string",
"buildingName": "string",
"floor": "string",
"postBox": "string",
"room": "string",
"postCode": "string",
"townName": "string",
"townLocationName": "string",
"districtName": "string",
"countrySubDivision": "string",
"country": "LT"
},
"identityType": "ANY_BIC"
},
"account": {
"iban": "LT121000011101001000",
"bic": "TESTLT21",
"proxy": {
"id": "string",
"proxyType": {
"code": "stri",
"proprietary": "string"
}
}
}
},
"amount": {
"currency": "EUR",
"value": 0.01
},
"purpose": "string",
"categoryPurpose": "BONU"
}
]
}
Message queue to send messages to
Allows to reject (return) previously received incoming payment either by inability to deliver funds to beneficiary or by confirming previously received payment cancellation request.
Available only on servers:
Accepts the following message:
Contains details of incoming payment return request
{
"messageType": "RejectPaymentMessage",
"data": [
{
"internalSepaMmsPaymentUid": "string",
"msgId": "string",
"txId": "string",
"reasonCode": "ACCOUNT_NUMBER_PROBLEM",
"chargeAmount": {
"currency": "EUR",
"value": 0.01
},
"originatorName": "string",
"originatorBic": "TESTLT21"
}
]
}
Message queue to send messages to
Allows to cancel previously sent outgoing payment by client or backend operator request.
Available only on servers:
Accepts the following message:
Contains details of outgoing payment cancellation request
{
"messageType": "CancelPaymentMessage",
"data": [
{
"internalUid": "string",
"msgId": "string",
"txId": "string",
"reasonCode": "DUPLICATE",
"additionalInfo": "string"
}
]
}
Message queue to send messages to
Allows to send a negative response (also known as “Resolution of investigation”) on previously received cancellation request.
Available only on servers:
Accepts the following message:
Contains details of incoming payment retainment decision
{
"messageType": "RetainPaymentMessage",
"data": [
{
"internalSepaMmsAppUid": "string",
"msgId": "string",
"txId": "string",
"reasonCode": "INSUFFICIENT_FUNDS",
"legalInfo": "string"
}
]
}
Message queue to send messages to
Allows to send a non-receipt claim for previously sent payment message, initiate an investigation for missing funds at the creditor or at agent along the processing chain.
Available only on servers:
Accepts the following message:
Contains details of payment non-receipt claim
{
"messageType": "ClaimNonReceiptMessage",
"data": [
{
"paymentUid": "string",
"msgId": "string",
"txId": "string",
"additionalInstructions": "string"
}
]
}
Message queue to send messages to
Allows to send a request to modify date and time at which the payment assignment was created
Available only on servers:
Accepts the following message:
Contains details of payment date correction claim
{
"messageType": "ClaimDateCorrectionMessage",
"data": [
{
"paymentUid": "string",
"msgId": "string",
"txId": "string",
"additionalInstructions": "string",
"claimedSettlementDate": "2019-11-21T16:32:59"
}
]
}
Message queue to send messages to
Allows to send a message by a case assignee to a case creator/case assigner. This message is used to inform of the resolution of a case, and optionally provides details about the corrective action undertaken by the case assignee - information on the return where applicable
Available only on servers:
Accepts the following message:
Contains details of positive or negative resolution of incoming claim
{
"messageType": "ResolveClaimMessage",
"data": [
{
"paymentUid": "string",
"msgId": "string",
"txId": "string",
"resolution": "ACCEPTED_NON_RECEIPT",
"reasonCode": "ORIGINAL_TX_NOT_RECEIVED",
"newSettlementDate": "2019-11-21T16:32:59",
"chargeAmount": {
"currency": "EUR",
"value": 0.01
}
}
]
}
Message queue to send messages to
Allows to request a status of previously sent payment non-receipt claim.
Available only on servers:
Accepts the following message:
Contains details of outgoing payment non-receipt claim status request
{
"messageType": "RequestNonReceiptClaimStatusMessage",
"data": [
{
"claimedPaymentUid": "string"
}
]
}
Message queue to send messages to
Allows to request a status of previously sent payment date correction claim.
Available only on servers:
Accepts the following message:
Contains details of outgoing payment date correction claim status request
{
"messageType": "RequestDateCorrectionClaimStatusMessage",
"data": [
{
"claimedPaymentUid": "string"
}
]
}
Message queue to receive messages from
This operation is invoked when new incoming payment is received
Available only on servers:
Accepts the following message:
Contains details of received incoming payment
{
"messageType": "PaymentReceivedMessage",
"data": [
{
"smaUid": "string",
"endToEndId": "string",
"message": {
"type": "FFCCTRNS",
"sender": "TESTLT21",
"docNo": "string",
"priority": 51,
"docCreated": "2019-11-21T16:32:59"
},
"paymentTimestamp": "2019-11-21T16:32:59",
"paymentInstructionNo": "string",
"msgId": "string",
"txId": "string",
"paymentCode": "stri",
"recipient": {
"person": {
"type": "ORG",
"name": "string",
"id": "string",
"countryCode": "LT",
"fullAddress": "string",
"address": {
"streetName": "string",
"buildingNumber": "string",
"buildingName": "string",
"floor": "string",
"postBox": "string",
"room": "string",
"postCode": "string",
"townName": "string",
"townLocationName": "string",
"districtName": "string",
"countrySubDivision": "string",
"country": "LT"
},
"identityType": "ANY_BIC"
},
"account": {
"iban": "LT121000011101001000",
"bic": "TESTLT21",
"proxy": {
"id": "string",
"proxyType": {
"code": "stri",
"proprietary": "string"
}
}
}
},
"ultimateRecipient": {
"type": "ORG",
"name": "string",
"id": "string",
"countryCode": "LT",
"fullAddress": "string",
"address": {
"streetName": "string",
"buildingNumber": "string",
"buildingName": "string",
"floor": "string",
"postBox": "string",
"room": "string",
"postCode": "string",
"townName": "string",
"townLocationName": "string",
"districtName": "string",
"countrySubDivision": "string",
"country": "LT"
},
"identityType": "ANY_BIC"
},
"payer": {
"person": {
"type": "ORG",
"name": "string",
"id": "string",
"countryCode": "LT",
"fullAddress": "string",
"address": {
"streetName": "string",
"buildingNumber": "string",
"buildingName": "string",
"floor": "string",
"postBox": "string",
"room": "string",
"postCode": "string",
"townName": "string",
"townLocationName": "string",
"districtName": "string",
"countrySubDivision": "string",
"country": "LT"
},
"identityType": "ANY_BIC"
},
"account": {
"iban": "LT121000011101001000",
"bic": "TESTLT21",
"proxy": {
"id": "string",
"proxyType": {
"code": "stri",
"proprietary": "string"
}
}
}
},
"initialPayer": {
"type": "ORG",
"name": "string",
"id": "string",
"countryCode": "LT",
"fullAddress": "string",
"address": {
"streetName": "string",
"buildingNumber": "string",
"buildingName": "string",
"floor": "string",
"postBox": "string",
"room": "string",
"postCode": "string",
"townName": "string",
"townLocationName": "string",
"districtName": "string",
"countrySubDivision": "string",
"country": "LT"
},
"identityType": "ANY_BIC"
},
"amount": {
"currency": "EUR",
"value": 0.01
},
"purpose": "string",
"categoryPurpose": "BONU"
}
]
}
Message queue to receive messages from
Received when outgoing payment request was confirmed by the CENTROlink system and successfully settled
Available only on servers:
Accepts the following message:
Contains details of settled incoming payment
{
"messageType": "PaymentSettledMessage",
"data": [
{
"internalId": "string",
"msgId": "string",
"txId": "string",
"paymentType": "OUTGOING_PAYMENT"
}
]
}
Message queue to receive messages from
This operation is invoked when previously received incoming payment is requested to be cancelled by beneficiary or beneficiary bank
Available only on servers:
Accepts the following message:
Contains details of incoming payment cancellation request
{
"messageType": "PaymentCancelledMessage",
"data": [
{
"originalSmaUid": "string",
"cancellationId": "string",
"originalMsgId": "string",
"e2eId": "string",
"msgId": "string",
"txId": "string",
"settlementDate": "2019-08-24",
"amount": {
"currency": "EUR",
"value": 0.01
},
"reasonCode": "AC03",
"additionalInfo": "string"
}
]
}
Message queue to receive messages from
This operation is invoked when when previously sent outgoing cancellation request was declined by beneficiary
Available only on servers:
Accepts the following message:
Contains details of outgoing payment retention
{
"messageType": "PaymentRetainedMessage",
"data": [
{
"wbUid": "string",
"retentionId": "string",
"originalMsgId": "string",
"e2eId": "string",
"msgId": "string",
"txId": "string",
"amount": {
"currency": "EUR",
"value": 0.01
},
"reasonCode": "LEGL",
"additionalInfo": "string"
}
]
}
Message queue to receive messages from
This operation is invoked when previously sent outgoing payment was returned by beneficiary bank
Available only on servers:
Accepts the following message:
Contains details of outgoing payment return
{
"messageType": "PaymentReturnedMessage",
"data": [
{
"originalWbUid": "string",
"originalMsgId": "string",
"originalMessageType": "OUTGOING_PAYMENT",
"returnId": "string",
"e2eId": "string",
"msgId": "string",
"txId": "string",
"originalAmount": {
"currency": "EUR",
"value": 0.01
},
"returnedAmount": {
"currency": "EUR",
"value": 0.01
},
"reasonCode": "CNOR"
}
]
}
Message queue to receive messages from
This message is received when previously sent payment was rejected by the CENTROlink system. This means that corresponding operation was unsuccessful
Available only on servers:
Accepts the following message:
Contains details of outgoing payment rejection
{
"messageType": "PaymentRejectedMessage",
"data": [
{
"originalInternalId": "string",
"msgId": "string",
"txId": "string",
"paymentType": "OUTGOING_PAYMENT",
"rejectionReason": "ZERO_AMOUNT",
"originatorBic": "TESTLT21"
}
]
}
Message queue to receive messages from
This operation is invoked when new payment non receipt claim is received
Available only on servers:
Accepts the following message:
Contains details of payment non-receipt claim
{
"messageType": "NonReceiptClaimMessage",
"data": [
{
"originalPaymentUid": "string",
"claimId": "string",
"msgId": "string",
"txId": "string",
"additionalInstructions": "string"
}
]
}
Message queue to receive messages from
This operation is invoked when new payment date correction claim is received
Available only on servers:
Accepts the following message:
Contains details of payment date correction claim
{
"messageType": "DateCorrectionClaimMessage",
"data": [
{
"originalPaymentUid": "string",
"msgId": "string",
"txId": "string",
"additionalInfo": "string",
"claimId": "string",
"claimedSettlementDate": "2019-08-24",
"originalSettlementDate": "2019-08-24"
}
]
}
Message queue to receive messages from
This operation is invoked when previously sent payment date correction or payment non receipt claim was resolved
Available only on servers:
Accepts the following message:
Contains details of claim resolution result
{
"messageType": "ClaimResolutionMessage",
"data": [
{
"originalPaymentUid": "string",
"msgId": "string",
"txId": "string",
"resolution": "ACCEPTED_NON_RECEIPT",
"resolutionId": "string",
"rejectionReason": "ORIGINAL_TX_NOT_RECEIVED",
"claimedSettlementDate": "2019-08-24",
"chargeAmount": {
"currency": "EUR",
"value": 0.01
}
}
]
}
Message queue to receive messages from
This operation allows to receive information about incoming and outgoing transactions committed during business day
Available only on servers:
Accepts the following message:
Contains details of daily transactions report
{
"messageType": "TransactionsReportMessage",
"data": [
{
"reportMsgId": "string",
"pageNumber": 0,
"last": true,
"transactionCount": 0,
"totalCreditDebitIndicator": "DEBIT",
"totalAmount": {
"currency": "EUR",
"value": 0.01
},
"transactions": [
{
"creditDebitIndicator": "DEBIT",
"amount": {
"currency": "EUR",
"value": 0.01
},
"debtor": {
"iban": "LT121000011101001000",
"bic": "TESTLT21"
},
"creditor": {
"iban": "LT121000011101001000",
"bic": "TESTLT21"
},
"acceptanceDateTime": "2019-11-21T16:32:59",
"transactionDateTime": "2019-11-21T16:32:59",
"settlementDate": "2019-08-24"
}
]
}
]
}
Message queue to receive messages from
This operation is invoked when a previously sent outgoing message did not pass syntax validation check.
Available only on servers:
Accepts the following message:
Contains details of outgoing payment validation errors
{
"messageType": "InvalidPayment",
"data": [
{
"internalId": "string",
"msgId": "string",
"txId": "string",
"additionalInfo": "string"
}
]
}
Message queue to receive messages from
This operation allows to receive incoming status requests related to previously received payment non-receipt claim
Available only on servers:
Accepts the following message:
Contains details of incoming payment non-receipt claim status request
{
"messageType": "NonReceiptClaimStatusRequestMessage",
"data": [
{
"originalPaymentUid": "string",
"statusRequestId": "string"
}
]
}
Message queue to receive messages from
This operation allows to receive incoming status requests related to previously received payment date correction claim
Available only on servers:
Accepts the following message:
Contains details of incoming payment date correction claim status request
{
"messageType": "DateCorrectionClaimStatusRequestMessage",
"data": [
{
"originalPaymentUid": "string",
"statusRequestId": "string"
}
]
}
Message queue to receive messages from
This operation allows to receive information regarding liquidity account(s) balance position during daily operations specifying turnovers with specific counterparties
Available only on servers:
Accepts the following message:
Contains details of incoming account statement report
{
"messageType": "SepaCreditAccountStatementReportMessage",
"data": [
{
"msgId": "string",
"documentId": "string",
"documentDateTime": "2019-11-21T16:32:59",
"bic": "TESTLT21",
"account": "LT121000011101001000",
"currency": "EUR",
"openingBalance": {
"balance": 0.01,
"availableBalance": 0.01
},
"closingBalance": {
"balance": 0.01,
"availableBalance": 0.01
},
"turnoversByParticipant": [
{
"bic": "TESTLT21",
"account": "LT121000011101001000",
"directions": [
{
"type": "DEBIT",
"amount": 0.01,
"transactionCount": 0
}
]
}
]
}
]
}
Contains details of outgoing payment creation request
Contains details of incoming payment return request
Contains details of outgoing payment cancellation request
Contains details of incoming payment retainment decision
Contains details of payment non-receipt claim
Contains details of payment date correction claim
Contains details of positive or negative resolution of incoming claim
Contains details of outgoing payment non-receipt claim status request
Contains details of outgoing payment date correction claim status request
Contains details of received incoming payment
Contains details of settled incoming payment
Contains details of outgoing payment rejection
Contains details of outgoing payment return
Contains details of incoming payment cancellation request
Contains details of outgoing payment retention
Contains details of payment non-receipt claim
Contains details of payment date correction claim
Contains details of claim resolution result
Contains details of daily transactions report
Contains details of outgoing payment validation errors
Contains details of incoming payment non-receipt claim status request
Contains details of incoming payment date correction claim status request
Contains details of incoming account statement report
Currency code (ISO 4217)
Country code (ISO 3166-1 alpha-2)
Information on party’s account
Information on party’s account
Monetary amount. Length of fractional part is 2 digits
Information on party’s personal details
Structured address.
Proxy of party’s account
Proxy type on party’s personal details
Category purpose of the payment
Payment return reason code (ISO20022)
A reason for payment rejection.
Payment cancellation reason code (ISO20022)
Payment retention reason code (ISO20022)
Applicable only for negative resolutions of payment non-receipt claims. Possible values:
Technical details of CENTROlink message
Information about turnover by counterparty
Information about transactions of specific direction