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 = Reference FreeText = Message | FinnishReference |
2 | bankpaymentmessage | String | 1 | Payment message: reference or 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 | Valtakatu 51 |
3 | postcode | String | 0...1 | Receivers postal code | 53100 |
3 | town | String | 0...1 | Receivers town | Lappeenranta |
3 | country | String | 0...1 | Receivers country as ISO-3166 alpha-2 code | |
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 Please note the information about due date at the beginning of the documentation | 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 |
Did you find it helpful? Yes No
Send feedback