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ó.
Desenvolupadors
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.
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"
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": []
}
}
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"
}
}
Paràmetres, resultats i errors de POST /my-bank-match/. El detall complet és a la guia d'integració.
| Paràmetre | Validació |
|---|---|
api_key | La seva clau d'API, amb el producte MyBankMatch actiu i quota disponible. |
iban | IBAN 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. |
name | Nom de la persona o empresa que diu ser-ne titular, de fins a 140 caràcters. |
result | Significat | Consumeix quota | Camps 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 |
| Codi d'error | Significat |
|---|---|
2 | Crida incorrecta: mètode, clau d'API, producte no actiu o límit de crides. |
4000 | IBAN no vàlid. |
4001 | Nom del titular no vàlid. |
1 | Error intern. |
Els errors no es cobren ni consumeixen quota.
Si ja utilitza l'API de Wealthreader, MyBankMatch respon amb la mateixa estructura i els mateixos hàbits d'integració.
L'IBAN i el nom es validen abans de consultar el banc: una dada mal formada retorna un error a l'instant.
MATCH, PARTIAL_MATCH i NO_MATCH consumeixen quota. Les consultes que no arriben a una conclusió, no.
La guia pas a pas i la referència de l'API descriuen el contracte complet, amb exemples.
Obrir la guia de MyBankMatch (s'obre en una pestanya nova) Obrir la referència de l'API (s'obre en una pestanya nova) Sol·licitar accés
Li mostrem MyBankMatch amb els pagaments i les altes del seu negoci.