La stessa struttura di sempre
Se utilizza già l’API di Wealthreader, MyBankMatch risponde con la stessa struttura e le stesse abitudini di integrazione.
Sviluppatori
MyBankMatch è un endpoint dell’API di Wealthreader: HTTPS, parametri di modulo e risposta JSON. Invii l’IBAN e il nome, e riceva il risultato della verifica.
Per attivare il servizio colleghiamo una sola volta un conto della Sua azienda dal pannello Clienti di Wealthreader: è quello che effettua le interrogazioni di Verifica del beneficiario. I Suoi clienti e fornitori non devono fare nulla.
Una richiesta POST con la Sua chiave API, l’IBAN del conto e il nome della persona o dell’azienda che dichiara di esserne l’intestataria.
curl https://api.wealthreader.com/my-bank-match/ \
-d api_key=$API_KEY \
-d iban=ES9121000418450200051332 \
--data-urlencode name="Talleres Ruiz SL"
La risposta arriva nella stessa chiamata, con la stessa struttura del resto dell’API: success, payload e statistics.
{
"success": true,
"payload": {
"result": "MATCH"
},
"statistics": {
"SESSION": "…",
"execution_time": 1.84,
"warnings": []
}
}
Se il nome è simile ma non identico, la risposta include suggested_name con il nome registrato presso la banca.
I valori sono illustrativi.
{
"success": true,
"payload": {
"result": "PARTIAL_MATCH",
"suggested_name": "Talleres Ruiz Martínez SL"
}
}
Parametri, risultati ed errori di POST /my-bank-match/. Il dettaglio completo è nella guida all’integrazione.
| Parametro | Convalida |
|---|---|
api_key | La Sua chiave API, con il prodotto MyBankMatch attivo e quota disponibile. |
iban | IBAN di un paese SEPA. Spazi e maiuscole vengono ignorati; si controllano la lunghezza prevista per il paese e le cifre di controllo. |
name | Nome della persona o dell’azienda che dichiara di essere intestataria, fino a 140 caratteri. |
result | Significato | Consuma quota | Campi aggiuntivi |
|---|---|---|---|
MATCH |
Il nome coincide con l’intestatario del conto. | Sì | — |
PARTIAL_MATCH |
Il nome è simile a quello dell’intestatario; suggested_name riporta il nome registrato presso la banca. | Sì | suggested_name |
NO_MATCH |
Il nome non corrisponde all’intestatario del conto. | Sì | — |
NOT_CONFIGURED |
La Sua chiave non ha ancora un conto collegato; setup_url porta al collegamento. | No | setup_url |
REAUTH_REQUIRED |
La banca collegata richiede una nuova autenticazione; setup_url porta alla riconnessione. | No | setup_url, reason_code |
NOT_POSSIBLE |
La banca non ha potuto verificare il conto in questo momento; reason indica il motivo. | No | reason |
| Codice di errore | Significato |
|---|---|
2 | Chiamata errata: metodo, chiave API, prodotto non attivo o limite di chiamate. |
4000 | IBAN non valido. |
4001 | Nome dell’intestatario non valido. |
1 | Errore interno. |
Gli errori non vengono addebitati né consumano quota.
Se utilizza già l’API di Wealthreader, MyBankMatch risponde con la stessa struttura e le stesse abitudini di integrazione.
L’IBAN e il nome vengono convalidati prima di interrogare la banca: un dato malformato restituisce subito un errore.
MATCH, PARTIAL_MATCH e NO_MATCH consumano quota. Le interrogazioni che non giungono a una conclusione, no.
La guida passo passo e il riferimento dell’API descrivono il contratto completo, con esempi.
Apri la guida di MyBankMatch (si apre in una nuova scheda) Apri il riferimento dell’API (si apre in una nuova scheda) Richiedi l’accesso
Le mostriamo MyBankMatch applicato ai pagamenti e alle registrazioni della Sua attività.