Sviluppatori

Un’API. Un verdetto per conto.

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.

  1. Invii IBAN e nome

    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"
  2. Riceva il risultato

    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": []
      }
    }
  3. Corrispondenza parziale: nome suggerito

    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"
      }
    }

Riferimento rapido

Parametri, risultati ed errori di POST /my-bank-match/. Il dettaglio completo è nella guida all’integrazione.

Parametri della richiesta
ParametroConvalida
api_keyLa Sua chiave API, con il prodotto MyBankMatch attivo e quota disponibile.
ibanIBAN di un paese SEPA. Spazi e maiuscole vengono ignorati; si controllano la lunghezza prevista per il paese e le cifre di controllo.
nameNome della persona o dell’azienda che dichiara di essere intestataria, fino a 140 caratteri.
Valori di result
resultSignificatoConsuma quotaCampi 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
Codici di errore
Codice di erroreSignificato
2Chiamata errata: metodo, chiave API, prodotto non attivo o limite di chiamate.
4000IBAN non valido.
4001Nome dell’intestatario non valido.
1Errore interno.

Gli errori non vengono addebitati né consumano quota.

Dettagli di integrazione

La stessa struttura di sempre

Se utilizza già l’API di Wealthreader, MyBankMatch risponde con la stessa struttura e le stesse abitudini di integrazione.

Convalida prima della banca

L’IBAN e il nome vengono convalidati prima di interrogare la banca: un dato malformato restituisce subito un errore.

Paga solo ciò che è conclusivo

MATCH, PARTIAL_MATCH e NO_MATCH consumano quota. Le interrogazioni che non giungono a una conclusione, no.

Documentazione pubblica

La guida passo passo e il riferimento dell’API descrivono il contratto completo, con esempi.

Prima di inviare il denaro, verifichi a chi

Le mostriamo MyBankMatch applicato ai pagamenti e alle registrazioni della Sua attività.

Richieda una demo