MeR TPP sustav digitalnog bankarstva

v1/getPaymentStatus - POST

Opis: Iniciranje provjere statusa plaćanja

URL (test): https://testapi.e-plati.hr/api/v1/getPaymentStatus

URL (produkcija): ../v1/getPaymentStatus

Specifikacija requesta - JSON:

Parametri: NEMA

	Opis	Tip podatka	Obavezno
.
header			DA
Content-Type	application/json	string	DA
X-Request-ID	Jedinstveni identifikator REST zahtjeva (requesta), jedinstven za svaki REST poziv.	UUID	DA
body			DA
username	Jedinstveni identifikator korisnika	string	DA
password	Password	string	DA
companyId	OIB pravne osobe	string	DA
companyBu	Oznaka podružnice ili druge izdvojene poslovne jedinice.	string	NE
softwareId	Jedinstvena oznaka poslovnog sustava (ERP)	string	DA
merPaymentId	Jedinstveni identifikator plaćanja u MeR TPP sustavu. Mora biti zadan jedan od parametara merPaymentId ili merERPPaymentId. Ukoliko su zadana oba parametra, onda se dohvat transakcije radi po merPaymentId (drugi parametar – merERPPaymentId - se zanemaruje.)	string	NE
merERPPaymentId	Jedinstveni identifikator plaćanja u ERP sustavu. Mora biti zadan jedan od parametara merPaymentId ili merERPPaymentId. Dohvat po ovom parametru je moguć jedino ukoliko se merPaymentId ne dostavi, a merERPPaymentId dostavi.	string	NE

Specifikacija response - JSON:

	Opis	Tip podatka	Obavezno
.
header			DA
Content-Type	application/json	string	DA
X-Request-ID	Jedinstveni identifikator requesta, jedinstven za svaki REST poziv. Ovo je identifikator koji je MeR TPP zaprimio od ERP sustava. Dostavlja se u neizmijenjenom obliku u odgovoru na zahtjev kod svih važnijih transakcija. Npr. iniciranje plaćanja i sl.	UUID	DA
body			DA
transactionStatus	Status transakcije. ISO 20022 šifra statusa plaćanja	transactionStatus	DA
merPaymentId	Jedinstveni identifikator plaćanja u MeR TPP sustavu	UUID	NE
merERPPaymentId	Jedinstveni identifikator plaćanja u ERP sustavu	UUID	NE
merChangeTime	Informacija o datumu i vremenu ažuriranja podatka preko PSD API-ja banke.	ISODateTime	DA
scaRedirect	URL za autorizaciju plaćanja na strani banke. Nakon uspješno provedenog prvog koraka iniciranja plaćanja potrebno je korisnika (vlasnik/imatelj SCA uređaja od banke, npr. mToken) poslati putem ovog URL-a na stranice banke kako bi obavio autorizaciju plaćanja. Ovisno o tipu izabranog tijeka plaćanja (flowType), ovaj link može voditi najprije na MeR Payment Info web stranicu ili direktno na Web stranice banke kod koje se provodi autorizacija plaćanja.	URL	NE
psuMessage	Opcionalna poruka koju je MeR TPP sustav zaprimio, a namijenjena je korisniku. Npr. može se raditi o uputi za autorizaciju i sl.	String	NE
xmlSctResp	Base64 encoded XML pain.002 datoteka. Originalna XML datoteka odgovora na pain.001 datoteku napravljena prema važećem HR SEPA standardu. Datoteka od banke je pretvorena u Base64 format. Ovaj element može biti dostavljen ukoliko se radi iniciranom plaćanju putem datoteke (plaćanje putem datoteke se inicira na bulkPayments endpointu).	Base64	NE

Primjer 1 JSON - POST request:

	
		POST /api/v1/getPaymentStatus HTTP/1.1
		Host: irpsd2.dynu.net:8040
		X-Request-ID: ffe51d54-34a6-4054-9855-9247d7761045
		Content-Type: application/json
		Content-Length: 211
		{
		"username": "clUser",
		"password": "clUser123%",
		"companyId": "99999999927",
		"companyBu": "",
		"softwareId": "Test-001",
		"merERPPaymentId": "267ff97b-71d4-4334-879c-1abc15269e4b"
		}

Primjer 1 JSON - response body:

	

		{
			"transactionStatus": "RCVD",
			"merPaymentId": "53576207-55f2-47c5-a7a3-31626149595f",
			"merERPPaymentId": "267ff97b-71d4-4334-879c-1abc15269e4b",
			"merChangeTime": "2021-09-09T15:08:51",
			"scaRedirect": "https://irpsd2.dynu.net:8030/status/payment/FggaKNyBSZIPvjwecKfXAeJkWnSMTEnbrTyXrk82HR2Yc_s04fNjLsZZoZTeyf4yrVu47arjYUjsygQPPOKg1T-g8FFm5p3p07wqCx0fXvJ2uxtd3PHDc8auTWUSLG6"
		   }