Integració MONEI
Estat de la integració amb MONEI — encara no alliberada, què existeix ja darrere del flag, per què no té recurs de mandats, i la superfície v1 i MCP exacta que apareix en alliberar-se.
MONEI encara no està disponible. Els seus endpoints v1 i les seves tools MCP
no estan registrats, així que cridar-los avui retorna 404 route_not_found.
Aquesta pàgina documenta l'estat de la integració i la superfície que
apareixerà quan s'alliberi — no és una guia d'ús.
MONEI és una passarel·la de pagament espanyola que cobra amb targeta i Bizum. Els diners es mouen en el moment de la captura, com en una passarel·la de targeta i a diferència de la domiciliació directa SEPA — que és la raó que la seva integració tingui una forma una mica diferent de la de GoCardless.
Què vol dir «encara no alliberada»
L'única font de veritat és la llista de passarel·les de pagament alliberades del
backend (integrations.released_providers), que avui conté només Stripe. És
configuració, no codi, així que una passarel·la s'encén sense desplegar codi.
Mentre MONEI sigui fora d'aquesta llista:
- El seu bloc de rutes v1 no està registrat. Els endpoints
/v1/monei-autoinvoicing/*no existeixen — no són al registre de rutes, ni a l'especificació OpenAPI, ni a la referència d'API d'aquest lloc. - Les seves tools MCP queden filtrades del servidor públic.
- La passarel·la apareix com a «Properament» al marketplace d'integracions del Dashboard, i el flux de connexió està bloquejat també al command handler.
- L'endpoint de comptes connectats agnòstic de passarel·la filtra els seus resultats a les passarel·les alliberades, així que cap compte de MONEI no apareix tampoc per aquí.
Les classes estan adormides, no absents. L'alliberament canvia una llista.
Sense recurs de mandats, i no és una omissió
GoCardless cobra per domiciliació directa SEPA, així que un mandat — l'autorització permanent del client per treure diners del seu compte bancari — és un objecte de primer nivell amb el seu propi cicle de vida, i té el seu propi endpoint i la seva pròpia tool MCP.
MONEI no fa servir domiciliació directa SEPA. No hi ha cap autorització
permanent que modelar, així que no hi ha recurs mandates, ni estats de mandat
que sincronitzar, ni webhooks de mandats. Si estàs portant una integració escrita
contra GoCardless, aquella branca sencera desapareix; no hi ha res sobre què
mapejar-la.
Què existeix ja darrere del flag
| Peça | Estat |
|---|---|
| Flux de connexió | Construït. MONEI s'autentica amb una API key, no amb OAuth 2 |
| Verificació de la firma del webhook | Construïda |
| Normalitzador d'esdeveniments | Construït — mapeja els estats de pagament de MONEI sobre els mateixos esdeveniments de pagament interns que fa servir el pipeline de Stripe |
| Comptes connectats per passarel·la | Construïts — llistar, obtenir, actualitzar i desconnectar, replicant el model multi-botiga de Stripe |
| Cobraments i rectificatives auto-facturats | Construïts — mateixes regles de decisió, mateixa alta a VeriFactu que a Stripe |
| Mandats | No aplica — vegeu més amunt |
Quins estats facturen, i quins no ho fan a propòsit
MONEI informa de l'estat d'un pagament com un status del mateix objecte de
pagament, i el normalitzador s'hi basa:
| Estat de MONEI | Què produeix |
|---|---|
SUCCEEDED | Es tracta com a cobrat → corre el flux d'auto-facturació |
REFUNDED, PARTIALLY_REFUNDED | Es tracten com a devolució → flux de factura rectificativa, total o parcial |
FAILED, CANCELED | Es registren com a cobrament fallit; no s'emet res |
AUTHORIZED | S'ignora a propòsit — una autorització sense captura no són diners cobrats, i facturar-la seria facturar un cobrament que potser no es capturarà mai |
| Qualsevol altre | Es registra com a esdeveniment desconegut |
Un pagament sense identificador es descarta abans que cap altra cosa: sense id no hi ha identitat canònica ni clau d'idempotència, així que no es podria deduplicar ni reprocessar amb seguretat.
La superfície que apareix en alliberar-se
Endpoints v1
| Endpoint | Scope |
|---|---|
GET /v1/monei-autoinvoicing/connected-accounts | monei_autoinvoicing:read |
GET /v1/monei-autoinvoicing/connected-accounts/{account} | monei_autoinvoicing:read |
PUT /v1/monei-autoinvoicing/connected-accounts/{account} | monei_autoinvoicing:write |
DELETE /v1/monei-autoinvoicing/connected-accounts/{account} | monei_autoinvoicing:write |
GET /v1/monei-autoinvoicing/payments | monei_autoinvoicing:read |
GET /v1/monei-autoinvoicing/correctives | monei_autoinvoicing:read |
El llistat de cobraments porta un filtre origin (subscription / oneshot) per
simetria amb les altres passarel·les. Si MONEI no té cobraments de subscripció
teus, origin=subscription retorna una pàgina buida en comptes d'un error.
Tools MCP
list_monei_connected_accounts, get_monei_connected_account,
update_monei_connected_account, disconnect_monei_connected_account,
list_monei_autoinvoiced_payments i list_monei_autoinvoiced_correctives — una
per cada endpoint de dalt, amb els mateixos scopes.
Requisit de pla
La integració amb MONEI és un mòdul dels plans Empresario i Enterprise, igual que les integracions amb Stripe i GoCardless. Ser al pla correcte no bastarà per si sol mentre la passarel·la segueixi sense alliberar-se — s'han de complir les dues condicions.
Equivalències amb el flux de Stripe
La part específica de cada passarel·la acaba al normalitzador: a partir d'aquí, totes les passarel·les comparteixen el mateix pipeline de facturació, les mateixes decisions fiscals i la mateixa alta a VeriFactu que descriu Auto-facturació amb Stripe.
| Concepte | Stripe | MONEI |
|---|---|---|
| Autenticació | OAuth 2 (Stripe Connect) | API key |
| Multi-botiga | connected-accounts per compte | Mateix model, sota monei-autoinvoicing/connected-accounts |
| Senyal de «cobrament amb èxit» | charge.succeeded / invoice.paid | Estat de pagament SUCCEEDED |
| Devolucions | charge.refunded → factura rectificativa | REFUNDED / PARTIALLY_REFUNDED → factura rectificativa |
| Autorització sense capturar | No es factura | AUTHORIZED, no es factura |
| Mandats | No aplica | No aplica |
| Cicles de subscripció | invoice.paid amb un billing_reason de subscripció | Sense branca equivalent al normalitzador |
| Conciliació de payouts | Suportada | Avui no coberta |
Què funciona avui de totes maneres
La safata d'esdeveniments d'integració és
agnòstica de la passarel·la i està registrada sense condicions, així que
provider=monei hi és un valor de filtre vàlid des del primer dia — inclosos els
esdeveniments històrics, que és justament la raó que aquestes files no s'amaguin.