neo-pays

Comptes de collecte

Page générée depuis la spécification OpenAPI que la passerelle sert (GET /v1/openapi.json). Ne la modifiez pas à la main : elle est réécrite à chaque build.

Méthode Chemin Description
POST /v1/collection-accounts Creer un IBAN virtuel pour un client d'un systeme partenaire
GET /v1/collection-accounts/{ncp}/rib Telecharger le RIB (PDF)
POST /v1/collection-accounts/{ncp}/status Activer ou desactiver un IBAN virtuel
POST /v1/collection-accounts/{ncp}/holder Mettre a jour le titulaire d'un IBAN virtuel

POST /v1/collection-accounts

Creer un IBAN virtuel pour un client d'un systeme partenaire

Reserve aux CLIENTS SYSTEME omnibus (neo-card, neo-tpe). Un marchand ordinaire n'y a pas acces : son propre compte est cree automatiquement a l'approbation KYB et se consulte au tableau de bord.

Les identites transmises ici sont EXIGEES PAR LA BANQUE pour ouvrir un compte. neo-pays les transmet et n'en conserve rien : aucun client de systeme partenaire n'est enregistre chez nous, sous aucune forme.

⚠️ Conservez le ncp renvoye : toute operation ulterieure l'adresse, et neo-pays ne garde aucune ligne permettant de le retrouver.

⚠️ En cas de reponse 409 ambiguous_create, NE REESSAYEZ PAS : un compte peut exister a la banque. Cette API n'a pas de cle d'idempotence et une seconde tentative creerait un second compte reel.

Réponses

  • 201 — Compte cree
  • 400 — Requete invalide
  • 403 — Ce client n'est pas un client systeme omnibus
  • 409 — Issue INCONNUE — ne pas reessayer
  • 503 — La banque est injoignable

GET /v1/collection-accounts/{ncp}/rib

Telecharger le RIB (PDF)

Paramètres

Nom Emplacement Requis Description
ncp path oui Numero de compte rendu a la creation.

Réponses

  • 200 — Le PDF, tel quel
  • 403 — Ce compte appartient a un marchand neo-pays
  • 503 — La banque est injoignable

POST /v1/collection-accounts/{ncp}/status

Activer ou desactiver un IBAN virtuel

⚠️ C'est le VRAI interrupteur, et il agit A LA BANQUE : un compte desactive ne peut plus RECEVOIR de virements. Aucun drapeau chez neo-pays n'a cet effet.

Paramètres

Nom Emplacement Requis Description
ncp path oui

Réponses

  • 200 — Applique
  • 400 — "enabled" manquant ou invalide
  • 403 — Ce compte appartient a un marchand neo-pays
  • 503 — La banque est injoignable

POST /v1/collection-accounts/{ncp}/holder

Mettre a jour le titulaire d'un IBAN virtuel

Change le nom et l'adresse que la banque detient pour ce compte (Eucalyptus §9). Le numero de compte et l'IBAN restent inchanges.

⚠️ ENVOYEZ LE TITULAIRE COMPLET, pas seulement les champs modifies. La specification marque chaque champ facultatif et ne dit nulle part ce que devient un champ OMIS : « laisse inchange » et « mis a vide » sont tous deux compatibles avec le texte, et la difference est qu'une modification d'adresse seule effacerait peut-etre le nom sur un enregistrement bancaire. Relisez les valeurs courantes et renvoyez-les avec ce qui change.

Paramètres

Nom Emplacement Requis Description
ncp path oui

Réponses

  • 200 — Applique
  • 400 — nom manquant
  • 403 — Ce compte appartient a un marchand neo-pays
  • 503 — La banque est injoignable