API Reference

Document Types (Keys) in the API

Overview of the document types handled by Mipise Payment Services. Includes required documents per user type, a full list of document keys used in the API, and usage guidance.

🧭 1. Overview

When submitting documents via the API, each file must be categorized using a document key.

⚠️ Required documents depend on the person type:

  • Individual → Only identity_proof is required
  • Legal Entities → Typically require:
    • identity_proof
    • registration_proof_of_the_legal_entity
    • ubo_declarative_form

❗️

Additional documents may be requested later, depending on the user’s profile and the regulatory context.
You should only provide the core documents initially.


📘 2. Full list of document keys

Below is the full list of document keys you may encounter when using the API.
You can use them when uploading documents or filtering via GET /documents/list.

KeyDescription
identity_proofIdentity document (see accepted types below)
registration_proof_of_the_legal_entityOfficial proof of registration (see details below)
ubo_declarative_formDeclaration of Ultimate Beneficial Owners (UBOs)
statusCompany statutes (requested only in specific cases)
doc_public_associationDocuments specific to public associations (rarely requested)
activity_proofProof of business activity (case-by-case basis)
ppe_declarationPolitically Exposed Person (PEP) declaration (if applicable)

ℹ️

Only the most common document types are detailed in the next sections.
Other keys may be requested dynamically based on the user's situation.


🧍 3. Individuals

Required document key: identity_proof

Accepted document types:

  • Passport
  • National ID card
  • Residence permit

🏢 4. Legal Entities

Below are the categories of legal entities supported by the API and their required documents.


👤 4.1 Sole Proprietorship (Entrepreneur individuel)

KeyDescription
identity_proofIdentity document (same as Individuals)
registration_proof_of_the_legal_entityRegistration proof from the official national registry, not older than 3 months:
• Inscription RCS

🏢 4.2 All Company Types (Tout type d’entreprises)

KeyDescription
identity_proofIdentity document of the legal representative (same accepted types as Individuals)
registration_proof_of_the_legal_entityOne of the following documents:
• AVIS SITUATION SIRENE INSEE (less than 3 months)
• KBIS extract (less than 3 months)
• Municipal/Departmental/Regional Council deliberation
• JORF publication (official creation/modification/dissolution)
• Prefectoral decree authorizing or confirming the above
• Kbis extract for municipal or intermunicipal régies
• SIRENE registration certificate
• ACPR license
• ORIAS registration
• Notarial office creation/recovery deed
• Professional liability insurance
• Caisse de Garantie des Notaires proof
• Carte Professionnelle de Santé (CPS)
• Current civil liability insurance certificate
• Professional ID card from the Bar association
• Professional ID card from the Order of Chartered Accountants
• Registration certificate from the Order of Chartered Accountants
ubo_declarative_formFormulaire de déclaration des bénéficiaires effectifs (UBO form)

🤝 4.3 Associations (including religious associations)

KeyDescription
identity_proofIdentity document of the legal representative (same accepted types as Individuals)
registration_proof_of_the_legal_entityOne of the following documents:
• Préfecture declaration receipt
• Publication in the Official Journal (site print accepted)
• SIRENE declaration (< 3 months)
• Extract from the JOAFE for diocesan associations or dioceses
ubo_declarative_formUBO DECLARATIVE FORM including:
• Board members
• Direction council and/or legal representative (bishop, priest, or pastor)

📊 5. Matching Table: person type → Required documents

Person Typeidentity_proofregistration proof of the legal entityubo declarative form
individual✅ Individual
sole_proprietorship✅ LR
company✅ LR + UBO✅ (standard UBO form)
association✅ LR + UBO✅ (board or religious council members)

📝 Legend:

  • LR = Legal Representative
  • UBO = Ultimate Beneficial Owner
  • ✅ = Required
  • ❌ = Not required

Feel free to reach out to Mipise Payment Services support for further clarification or if your structure type is not listed here.