Payments

Payment Initiation Service Providers (PISP) are authorized to initiate a payment on behalf of the customer if they have given such permission.

Citadele API contains these endpoints:

Create payment initiation – allows initiating single SEPA payment

Get payment details – allows to get back transaction details of given payment

Get payment status – allows getting status of given payment

Funds confirmation – checks whether a specific amount is available at point of time of the request on a given account or card.

How to use payment initiation service

create payment initiation request
create payment initiation

curl --cert ./cert.pem \ -H "X-Request-ID: <random-UUID>" \ -H "TPP-Redirect-URI: <TPP-SUCCESS-URL-REDIRECT>" \ -H "TPP-Nok-Redirect-URI: <TPP-FAILURE-URL-REDIRECT>" \ -H "PSU-IP-Address: <IP-Address>" \ https://api.citadele.lv/psd2/v1/payments/sepa-credit-transfers \ -X POST \ -H "Content-Type: application/json" \ -d '{"creditorAccount":"LV59PARX00XXXXXXX0001","debtorAccount":"LV52PARX00XXXXXXX0001", "creditorName": "KRISTAPS PORZINĢIS", "instructedAmount": {"currency": "EUR", "amount": 19.99}, "creditorAddress": {"buildingNumber": "2a", "city": "Riga","country": "LV", "postalCode": "LV-10","street": "Republikas Laukums"}, "remittanceInformationUnstructured": "Payment for good cause"}') }

In response you will receive:
Response

200 OK
{

"transactionStatus":null,

"paymentId":"f9fb461a52804c4ebe4377b80f5bd079",

"transactionFees":null,

"transactionFeeIndicator":null,

"scaMethods":null,

"chosenScaMethod":null,

"challengeData":null,

"_links":{
"scaRedirect":"https://online.citadele.lv/amai/startp.htm?jsessionid=route.amai-miranda-2&loc=LV&lang=EN&url=<TPP-SUCCESS-URL-REDIRECT>&notOkUrl=<TPP-FAILURE-URL-REDIRECT>&token=eyJhbGciOiJSUzUxMiJ9.eyJpc3MiOiJDb25zZW50TWFuYWdlciIsInN1YiI6InBheW1lbnQiLCJkYXRhIjp7ImVuZFRvRW5kSWRlbnRpZmljYXRpb24iOm51bGwsImRlYnRvckFjY291bnQiOiJMVjUyUEFSWDAwMTQ5NzUzMjAwMDEiLCJpbnN0cnVjdGVkQW1vdW50Ijp7ImN1cnJlbmN5IjoiRVVSIiwiYW1vdW50IjoiMS4xMSJ9LCJjcmVkaXRvckFjY291bnQiOiJMVjU5UEFSWDAwMjExMjk4MzAwMDEiLCJjcmVkaXRvckFnZW50IjpudWxsLCJjcmVkaXRvck5hbWUiOiJNT05UQSBQUklFRMSSTkEtU0VSR0lKRVZTS0EiLCJjcmVkaXRvckFkZHJlc3MiOnsic3RyZWV0IjoiUmVwdWJsaWthcyBMYXVrdW1zIiwiYnVpbGRpbmdOdW1iZXIiOiIyYSIsImNpdHkiOiJSaWdhIiwicG9zdGFsQ29kZSI6IkxWLTEwIiwiY291bnRyeSI6IkxWIn0sInJlbWl0dGFuY2VJbmZvcm1hdGlvblVuc3RydWN0dXJlZCI6IlBTRDIgdGVzdCBwYXltZW50IHRvIHdpZmUiLCJwYXltZW50SWQiOiJmOWZiNDYxYTUyODA0YzRlYmU0Mzc3YjgwZjViZDA3MyIsInRwcElkIjoiUFNET1AtVEVTVC1UUFAtNmNkYTdmZTAtYzE2YSIsInRwcE5hbWUiOiJTQU5EQk9YY2l0YWRlbGUuZnktcGFzaHV0In0sImlhdCI6MTU2ODEwNjUyOCwiZXhwIjoxNTY4MTA3NDI4fQ.aLhbaTVcPGDGH5HlQYcTczXqjD18GRVTMhPe0OuX2vJ6lpTQJWPb44-uvXvDi4o4eJwQaF20g3CyZ_7T0PBLv7Bc5YPp5M-D4zNKcuZTYnMRrUuDhDM6nssJ-iAlUSd2SiviU7Z2obTZapNhXygjBidGafaR1Q4_nlBnn-1R0BPLUlGPn-c-HmMUBjxP0yGSSDw0NtAS-69wZ-hCV6EO-RQmn7ZtDOOCrnwcVQ5CcXo6e9QdmkNT341RY049RayBJnBV2QSycVPX4K0Ie5nm3GytZlEj2Nq9Hb42YCx10zXSSAedkrVqgGQEuWT2YAnG6gexBDuA"

},

"psuMessage":null,

"tppMessages":null

}

Extract paymentId → it can be later used to check payment status and payment info
To proceed - redirect PSU to URL extracted from "_links.scaRedirect"
open url in browser → you will receive AMAI authorization window.

After entering valid login name and valid password and submiting the page → authorization screen will be shown.
It will ask for authorization code depending on device being used by PSU.

After that payment details will be prepared (with data supplied in init payment API call)

After tapping next → authorization screen will be shown

After successful payment PSU is redirected to <TPP-SUCCESS-URL-REDIRECT>
If payment is cancelled then user is redirected to <TPP-FAILURE-URL-REDIRECT>
After that it is possible to check payment status and payment info
Get payment status

curl --cert ./cert.pem \
-X GET \
"https://api.citadele.lv/psd2/v1/payments/f9fb461a52804c4ebe4377b80f5bd079/status" \
-H "Accept: application/json" \
-H "PSU-IP-Port: <PSU_IP>" \
-H "X-Request-ID: <random_UUID>"

Response:
Payment status

200 OK
{"transactionStatus":"ACSC"}

Payment info request:
payment info request

curl --cert ./cert.pem \
-X GET \
"https://api.citadele.lv/psd2/v1/payments/f9fb461a52804c4ebe4377b80f5bd079" \
-H "Accept: application/json" \
-H "PSU-IP-Port: <PSU-IP>" \
-H "X-Request-ID: <random_UUID>")

Response:
Payment info

200 OK
{
   "endToEndIdentification":null,
   "debtorAccount":{
      "iban":"LV52PARX00XXXXXXX0001",
      "currency":null
   },
   "instructedAmount":{
      "currency":"EUR",
      "amount":"1.11"
   },
   "creditorAccount":{
      "iban":"LV59PARX00XXXXXXX0001",
      "currency":null
   },
   "creditorAgent":null,
   "creditorName":"KRISTAPS PORZIŅĢIS",
   "creditorAddress":null,
   "remittanceInformationUnstructured":null,
   "transactionStatus":"ACSC"
}