Inyett API / Confirmation of Payee
Confirmation of Payee
Commercial Description
Inyett Confirmation of Payee is used to verifiy that a payment account number is active and valid to pay to. Use Inyett Confirmation of Payee to verified that a account is owned by the specified organization.
Data on suppliers in the ERP gets old over time. Company information changes and the account number related to the supplier in the ERP might not be in use. If a supplier has used factoring companies to handle invoicing, an old account number might be assigned to the supplier. If a payement is sent to the wrong account number, time will have to be spent correcting the misstake, or even worse, the money will never return.
Use the 'post-endpoint' to send in the required information to validate and org.nr/account.nr connection.
The call will respond with the information stated below (Response).
|
Post
|
|
|
|
|---|---|---|---|
|
Description
|
|
||
| Country | SE/NO | Country of origin of the account number to validate. | If NO - Check against KAR. Caller ID is needed to ask (This is API key ore Inyett One account) |
| accountCountry | SE/NO | Country of origin of account number (Eg. Norway) | |
| orgNr | Company Registration Nr | ||
|
accountNr |
Account number | ||
| accountType | Account type |
|
Response
|
|
|---|---|
|
Response
|
Description
|
| "orgNr": "00996543218", | Company Registration Nr |
| "number": "99994411116", | Account number |
| "type": "Bank", | Account type |
| "country": "NO", | Orgin of account number (Eg. Norway) |
| "rating": 100, | Rating of validation (0-100) (100 is a fully validated match between org.nr and account nr. |
| "level": "green", | Green, yellow, red. (Green = 100, OK) |
| "message": "Ja" | Additional information from a external source, eg. KAR) |
| Response message | |
| message | Source: KAR |
| Code | Message (Kan kontot användas för inbetalning?) |
|---|---|
| 01 |
Ja, konto finnes |
| 02 |
Ja, konto finnes, men er omnummerert |
| 03 |
Nei, konto finnes ikke |
| 04 |
Nei, omnummerert tilkonto finnes ikke |
| 05 |
Nei, omnummeret tilbank deltar ikke i KAR |
| 06 |
Oppgitt bank ikke i KAR |
| 07 |
Oppgitt regnr finnes ikke |
| 08 |
Oppgitt konto ikke CDV gyldig |
| Code | Eies konto av oppgitt person / bedrift |
|
01 |
Ja, konto finnes og eies av angitt kunde |
| 02 | Ja, konto finnes, men er omnummerert og ny konto eies av angitt kunde |
| 03 | Nei, konto finnes men eies ikke av angitt kunde |
| 04 | Nei, konto finnes ikke |
| 05 | Nei, Angitt konto er omnummerert, men ny konto finnes ikke |
| 06 | Nei, Angitt konto er omnummerert, Ny konto finnes, men eies ikke av angitt kunde |
| 08 | Nei, angitt konto er omnummerert, men kan ikke verifisere da ny bank ikke deltar i KAR |
| 09 | Angitt regnr finnes ikke |
| 10 | Angitt konto ikke CDV gyldig |
| 11 | Angitt kundeID ikke gyldig |
| 12 | Konto finnes men eierskap kan ikke verifiseres |