Resource: payment.nv
HTTP-method: POST
Bank transfers can be imported via the API but they must be accepted or paid in Netvisor. Receiver bank account number must be a valid IBAN in Single Euro Payments Area (SEPA). Validity of BIC/SWIFT format is checked if Netvisor can not identify the bank from the given IBAN (see Supported banks). Currency of bank transfers in Netvisor is EUR.
If payment has a past due date, Netvisor will change the due date to the current date when the payment is paid in Netvisor. You can bundle multiple payments together regardless of whether they were imported via API or created in Netvisor. All payments that share the same payers account number and due date are taken into payment together. Payments can be edited in Netvisor after import.
Request:
Level | Element name | Type and length | Occurs | Description | Example |
root | root | Aggr. | 1 |
|
|
1 | payment | Aggr. | 1 |
|
|
2 | bankpaymentmessagetype | String | 1 | Message type: | FinnishReference |
2 | bankpaymentmessage | String | 1 | Payment message: | 1071 |
2 | recipient | Aggr. | 1 |
|
|
3 | organizationcode | String | 0...1 | Receivers business ID | 1234567-8 |
3 | name | String | 1 | Receivers name | Ville Valta |
3 | address | String | 0...1 | Receivers address. Mandatory if the recipient's account number is not a Finnish bank account. | Valtakatu 51 |
3 | postcode | String | 0...1 | Receivers postal code. Mandatory if the recipient's account number is not a Finnish bank account. | 53100 |
3 | town | String | 0...1 | Receivers town. Mandatory if the recipient's account number is not a Finnish bank account. | Lappeenranta |
3 | country | String | 0...1 | Receivers country as ISO-3166 alpha-2 code. Mandatory if the recipient's account number is not a Finnish bank account. | FI |
2 | sourcebankaccountnumber | Numeric | 1 | Payers bank account number | FI000998874123 |
2 | destinationbankaccount | Aggr. | 1 |
|
|
3 | bankname | String | 1 | Receivers banks name | Handelsbanken |
3 | bankbranch | String | 1 | Receivers BIC | HANDFIHH |
3 | destinationbankaccountnumber | Text | 1 | Receivers bank account number | FI000111234567 |
2 | duedate | Date | 1 | Due date | 2016-05-25 |
2 | amount | Numeric | 1 | Sum | 10,00 |
2 | paymentgroup | Aggr. | 0...1 |
|
|
3 | paymentgrouppayment | Aggr. | 0...n | Payment group (Old element, no need to use, check post) |
|
4 | sum | Numeric | 1 | Payment group sum |
|
4 | reference | Numeric | 1 | Payment group reference |
|