MeR TPP sustav digitalnog bankarstva

Metoda: v1/bulkPayments - POST

URL (test): https://testapi.e-plati.hr/api/v1/bulkPayments
URL (produkcija): LCZAJ_VanjskiSustavi.RESTUrl + /v1/bulkPayments

1. Kontrola prava pristupa

Za kontrolu prava korištenja metode u 098 se provjerava slijedeća operacija:

Aplikacija	Broj operacije	Kontrolirana metoda
150	eBank_Pay	Plaćanje naloga digitalnim bankarstvom
153	eBank_Pay	Plaćanje naloga digitalnim bankarstvom
192	eBank_Pay	Plaćanje naloga digitalnim bankarstvom
204	eBank_Pay	Plaćanje naloga digitalnim bankarstvom
212	eBank_Pay	Plaćanje naloga digitalnim bankarstvom
951	eBank_Pay	Plaćanje naloga digitalnim bankarstvom

2. Opis rada metode

Metoda vrši slanje propremljenih naloga za plaćanje u MeR TTP servis eBankarstva.

Koraci obrade:

1. Vrši se dohvat parametara iz LCSPI tablice LCZAJ_VanjskiSustavi za VsID = MeRAIS.
URL servisa - adresa servisa.
KorisnickoIme - za autentifikaciju na servis.
Zaporka - za autentifikaciju na servis.

2. Vrši se priprema naloga za plaćanje - SEPA pain.001 poruka koja je rezultat SQL procedure up_LC192_ZNKreiranjeDatotekeSEPAFormat.

3. Vrši se pozivanje metode web servisa v1/bulkPayments.
Priprema se vrši na način opisan u tablici u nastavku

4. Pozivanje metode web servisa (request) se logira u tablicu LCZAJ_VanjskiSustaviLog.

5. Logira se odgovor metode web servisa (response) u tablicu LCZAJ_VanjskiSustaviLog.

6. Vrši se preusmjeravanje na link za autorizaciju plaćanja koji vraća pozvana metoda u svom odgovoru nakon inicijalizacije plaćanja.

7. Nakon autorizacije i uspješno / neuspješno izvršenog plaćanja ručno se ažurira rezultat platne transakcije budući da LC SPI iniciranje plaćanja nije razvijeno u web okruženju.
Razvoj i dorade metode za 192 -> Obrada -> Plaćanje obveza --> Slanje na plaćanje za 6.70.10.00 --> Pogledaj ZAD 23/66067

3. Punjenje ulaznog JSON-a metode:

	Opis	O
.
header		1..1
Content-Type	application/json	DA
X-Request-ID	NEWID() - spremanje u NOVU KOLONU LCZAJ_VanjskiSustaviLog.RowGUID	DA
body		1..1
username	LCZAJ_VanjskiSustavi.KorisnickoIme	DA
password	LCZAJ_VanjskiSustavi.Zaporka	DA
companyId	LCZAJ_OsobniIdentifikacijskiBrojevi.OIB preko LCZAJ_Korisnici.OsobniIdentifikacijskiBrojeviID	DA
companyBu	''	NE
softwareId	LCZAJ_VanjskiSustavi.SoftwareID - NOVA KOLONA	DA
erpRedirectURI	NULL - nemamo ga	NE
erpNokRedirectURI	NULL - nemamo ga	NE
merERPPaymentId	NEWID() - spremanje u NOVU KOLONU LCZAJ_VanjskiSustaviLog.DatotekaGUID Razvoj za 192 Plaćanje obeza za 6.70.10.00: kada se šalje SEPA pain.001 datoteka iz SPI sustava sa lokacije 192 -> Obrada -> Plaćanje obveza --> Slanje na plaćanje da se umjesto NEWID šalje podatak iz polja ARH_DatotekeGUID iz tablice LC192_ZNDatoteka.	DA
psuId	Ako je LCZAJ_ZiroRacuni.psuId NULL ili '' tada se ne šalje element Ako je LCZAJ_ZiroRacuni.psuId varijabla $OIBK$ tada se puni OIB korisnika preko LCZAJ_Korisnici.OsobniIdentifikacijskiBrojevi Ako je LCZAJ_ZiroRacuni.psuId varijabla $OIBP$ tada se puni OIB ovlaštenika (operatera) preko LCZAJ_OperateriZaposleni Inače LCZAJ_ZiroRacuni.psuId	NE
psuIdType	LCZAJ_ZiroRacuni.psuIdType	NE
psuCorporateId	Ako je LCZAJ_ZiroRacuni.psuCorporateId NULL ili '' tada se ne šalje element Ako je LCZAJ_ZiroRacuni.psuCorporateId varijabla $OIBK$ tada se puni OIB korisnika preko LCZAJ_Korisnici.OsobniIdentifikacijskiBrojevi Inače LCZAJ_ZiroRacuni.psuCorporateId	NE
psuCorporateIdType	LCZAJ_ZiroRacuni.psuCorporateIdType	NE
vbdi	SUBSTRING(LCZAJ_ZiroRacuni.ZIRO,5,7) - za IBAN sa kojeg se vrši plaćanje. Obavezno provjeriti da li su prva dva znaka HR inače zaustaviti pripremu.	DA
xmlSct	pripremljena SEPA pain.001 poruka (datoteka) enkodirana u Base64 tip podatka	DA

Prilozi

Opis servisa - MeR-TPP-API za partnere.pdf.

ISO statusi transakcija.

Nekoliko poslovnih i tehničkih pravila:

minimalno jedan vanjski sustav mora biti označen za rad sa digitalnim bankarstvom

platni nalog mora imati barem jednu platnu transakciju u sebi

slanje dodatnih identifikatora prilikom pozivanja metode web servisa (psuId, psuIdType, psuCorporateId, psuCorporateIdType) isključivo ovise o zahtjevima poslovne banke sa čijeg se računa vrši plaćanje.

Primjer JSON - POST request:

	

	POST /api/v1/bulkPayments HTTP/1.1
	Host: irpsd2.dynu.net:8040
	X-Request-ID: a48dbe1e-745e-4daf-8981-b5fba4419fac
	Content-Type: application/json
	Content-Length: 10894
	
	{
		"username": "clUser",
		"password": "clUser123%",
		"companyId": "99999999927",
		"companyBu": "",
		"softwareId": "Test-001",
		"merERPPaymentId": "55776d0e-63e2-43dd-886f-4a7c97ec78ab",
		"vbdi": "2402006",
		"xmlSct": "PD94bWwgdmVyc2lvbj0iMS4wIiBlbmNvZGluZz0iVVRGLTgiPz4NCjxEb2N1bWVudCB4bWxucz0idXJuOmlzbzpzdGQ6aXNvOjIwMDIyOnRlY2g6eHNkOnNjdGhyOnBhaW4uMDAxLjAwMS4wMyI+DQogIDxDc3RtckNkdFRy
		ZkluaXRuPg0KICAgIDxHcnBIZHI+DQogICAgICA8TXNnSWQ+ODJiOWMwNjItMzExNi0xMWU5LWIyMTAtZDY2M2JkODczZDkzPC9Nc2dJZD4NCiAgICAgIDxDcmVEdFRtPjIwMTktMDItMTVUMDg6MzY6MTIuMzM0WjwvQ3JlRHRUbT4NCiA
		ICAgIDxOYk9mVHhzPjc8L05iT2ZUeHM+DQogICAgICA8Q3RybFN1bT43My45NDwvQ3RybFN1bT4NCiAgICAgIDxJbml0Z1B0eT4NCiAgICAgICAgPE5tPkdhbmRhbGYgR3JheTwvTm0+DQogICAgICA8L0luaXRnUHR5Pg0KICAgIDwvR3J
		wSGRyPg0KICAgIDxQbXRJb....."
	}

Primjer JSON - response:

	
	
	HTTP/1.x 201 Created
	X-Request-ID: d192c1b2-53d6-49e2-a3eb-d1498de1807f
	Content-Type: application/json
	{
		"transactionStatus": "RCVD",
		"merPaymentId": "f746fbf6-0ba6-4172-96c7-eb79bb042525",
		"merERPPaymentId": "55776d0e-63e2-43dd-886f-4a7c97ec78ab",
		"merChangeTime": "2021-09-09T21:31:51.5942258+02:00",
		"scaRedirect": "https://irpsd2.dynu.net:4200/payment-info-auth/th2ZXmslS3tA3jIvwQhT-as0WOvWPtvAmZVlybgD-7i00zWQFVWfnMO9Smu71lESI2hD1iBhPwwjVCRAXp9BSwT3rL1uLcrgyrAdJ71JZlT9g-YqgAyjJ-amBQXPTyox"
	}