Resurssi: payment.nv
HTTP-metodi: POST
Rajapinnan kautta voidaan tuoda uusia tilisiirtoja, jotka hyväksytään tai maksetaan Netvisorin tilisiirtonäkymästä. Tilisiirtoja voidaan tehdä SEPA-alueelle ja vastaanottajan tilinumeron täytyy olla IBAN-muotoinen. Tilinumeron oikeellisuus tarkastetaan tuonnin yhteydessä. BIC-koodin oikeellisuus tarkastetaan, jos Netvisor ei tunnista pankkia vastaanottajan tilinumeron perusteella (Tuetut pankit). Tilisiirtojen valuuttana käytetään Netvisorissa aina euroa.
Ulkomaan tilisiirroissa myös saajan osoitetiedot on pakolliset.
Mikäli tilisiirrolle tuodaan menneisyydessä oleva eräpäivä, vaihtaa Netvisor eräpäivän kuluvaan päivään, kun tilisiirto viedään maksuun. Tilisiirtoja on mahdollista muokata tuonnin jälkeen Netvisorissa. Useampia tuotuja tilisiirtoja on mahdollista maksaa samassa maksuerässä, minkä lisäksi normaaleja (Netvisorissa luotuja) ja rajapinnan kautta tuotuja tilisiirtoja voidaan niputtaa. Kaikki yhtä aikaa maksuun viedyt saman maksutilin ja maksupäivän tilisiirrot maksetaan yhdessä maksuerässä.
Tuotavan tilisiirron tiedot lähetetään kutsun mukana oheisen kuvauksen mukaisena XML:nä (POST-data). Yhdessä XML-tiedostossa voidaan tuoda kerrallaan yksi tilisiirto:
Taso | Elementti | Muoto | Ilmentymiä | Kuvaus | Esimerkki |
root | root | Aggregaatti | 1 |
|
|
1 | payment | Aggregaatti | 1 |
|
|
2 | bankpaymentmessagetype | Merkkijono | 1 | Viestin tyyppi: | FinnishReference |
2 | bankpaymentmessage | Merkkijono | 1 | Tilisiirron viesti: viitenumero tai viesti | 1071 |
2 | recipient | Aggregaatti | 1 | Vastaanottaja |
|
3 | organizationcode | Merkkijono | 0...1 | Vastaanottajan y-tunnus | 1234567-8 |
3 | name | Merkkijono | 1 | Vastaanottajan nimi | Ville Valta |
3 | address | Merkkijono | 0...1 | Vastaanottajan osoite. Pakollinen, jos vastaanottajan tilinumero ei ole suomalainen pankkitili. | Valtakatu 51 |
3 | postcode | Merkkijono | 0...1 | Vastaanottajan postinumero. Pakollinen, jos vastaanottajan tilinumero ei ole suomalainen pankkitili. | 53100 |
3 | town | Merkkijono | 0...1 | Vastaanottajan kaupunki. Pakollinen, jos vastaanottajan tilinumero ei ole suomalainen pankkitili. | Lappeenranta |
3 | country | Merkkijono | 0...1 | Vastaanottajan maa ISO-3166 alpha-2 muodossa. Pakollinen, jos vastaanottajan tilinumero ei ole suomalainen pankkitili. | FI |
2 | sourcebankaccountnumber | Numeerinen | 1 | Maksajan tilinumero | FI000998874123 |
2 | destinationbankaccount | Aggregaatti | 1 | Vastaanottajan pankkitili |
|
3 | bankname | Merkkijono | 1 | Vastaanottajan pankin nimi | Handelsbanken |
3 | bankbranch | Merkkijono | 1 | Vastaanottajan BIC | HANDFIHH |
3 | destinationbankaccountnumber | Merkkijono | 1 | Vastaanottajan tilinumero | FI000111234567 |
2 | duedate | Päivämäärä | 1 | Eräpäivä | 2016-05-2525.5.2016 |
2 | amount | Numeerinen | 1 | Summa | 10,00 |
2 | paymentgroup | Aggregaatti | 0...1 |
|
|
3 | paymentgrouppayment | Aggregaatti | 0...n | Maksuryhmä (Vanha elementti, ei enää tarvetta käyttää muutoksen jälkeen) |
|
4 | sum | Numeerinen | 1 | Maksuryhmän summa |
|
4 | reference | Numeerinen | 1 | Maksuryhmän viitenumero |
|