Desenvolupadors

Una API. Un veredicte per compte.

MyBankMatch és un punt de l'API de Wealthreader: HTTPS, paràmetres de formulari i resposta JSON. Enviï l'IBAN i el nom, i rebi el resultat de la verificació.

Per activar el servei vinculem una sola vegada un compte de la seva empresa des del panell de Clients de Wealthreader: és el que fa les consultes de Verificació del Beneficiari. Els seus clients i proveïdors no han de fer res.

  1. Enviï IBAN i nom

    Una petició POST amb la seva clau d'API, l'IBAN del compte i el nom de la persona o empresa que diu ser-ne titular.

    curl https://api.wealthreader.com/my-bank-match/ \
      -d api_key=$API_KEY \
      -d iban=ES9121000418450200051332 \
      --data-urlencode name="Talleres Ruiz SL"
  2. Rebi el resultat

    La resposta arriba en la mateixa crida, amb el mateix sobre que la resta de l'API: success, payload i statistics.

    {
      "success": true,
      "payload": {
        "result": "MATCH"
      },
      "statistics": {
        "SESSION": "…",
        "execution_time": 1.84,
        "warnings": []
      }
    }
  3. Coincidència parcial: nom suggerit

    Si el nom s'assembla però no és idèntic, la resposta inclou suggested_name amb el nom que consta al banc.

    Els valors són il·lustratius.

    {
      "success": true,
      "payload": {
        "result": "PARTIAL_MATCH",
        "suggested_name": "Talleres Ruiz Martínez SL"
      }
    }

Referència ràpida

Paràmetres, resultats i errors de POST /my-bank-match/. El detall complet és a la guia d'integració.

Paràmetres de la petició
ParàmetreValidació
api_keyLa seva clau d'API, amb el producte MyBankMatch actiu i quota disponible.
ibanIBAN d'un país SEPA. S'ignoren els espais i les majúscules; es comproven la longitud del seu país i els dígits de control.
nameNom de la persona o empresa que diu ser-ne titular, de fins a 140 caràcters.
Valors de result
resultSignificatConsumeix quotaCamps addicionals
MATCH El nom coincideix amb el titular del compte. Sí —
PARTIAL_MATCH El nom s'assembla al del titular; suggested_name porta el nom que consta al banc. Sí suggested_name
NO_MATCH El nom no correspon al titular del compte. Sí —
NOT_CONFIGURED La seva clau encara no té cap compte vinculat; setup_url porta a la vinculació. No setup_url
REAUTH_REQUIRED El banc vinculat demana tornar a autenticar-se; setup_url porta a la reconnexió. No setup_url, reason_code
NOT_POSSIBLE El banc no ha pogut verificar el compte en aquest moment; reason indica el motiu. No reason
Codis d'error
Codi d'errorSignificat
2Crida incorrecta: mètode, clau d'API, producte no actiu o límit de crides.
4000IBAN no vàlid.
4001Nom del titular no vàlid.
1Error intern.

Els errors no es cobren ni consumeixen quota.

Detalls d'integració

El mateix sobre de sempre

Si ja utilitza l'API de Wealthreader, MyBankMatch respon amb la mateixa estructura i els mateixos hàbits d'integració.

Validació abans del banc

L'IBAN i el nom es validen abans de consultar el banc: una dada mal formada retorna un error a l'instant.

Només paga el concloent

MATCH, PARTIAL_MATCH i NO_MATCH consumeixen quota. Les consultes que no arriben a una conclusió, no.

Documentació pública

La guia pas a pas i la referència de l'API descriuen el contracte complet, amb exemples.

Abans d'enviar els diners, comprovi a qui

Li mostrem MyBankMatch amb els pagaments i les altes del seu negoci.

Sol·licitar una demo