> ## Documentation Index > Fetch the complete documentation index at: https://docs.krypta-pay.com/llms.txt > Use this file to discover all available pages before exploring further. # Declare a manual deposit with proof ## OpenAPI ````yaml /openapi.json post /v1/deposits/ openapi: 3.1.0 info: title: KryptaPay API description: >- API B2B de paiements numériques pour l'Afrique francophone. ## Authentification Deux méthodes sont supportées : - **Session utilisateur** : JWT signé dans un cookie `kp_token` (HttpOnly, SameSite=Lax) — utilisé par le tableau de bord. - **Clé API** : header `Authorization: Bearer kp__xxx` — utilisé par les intégrations serveur. Les endpoints sensibles exigent l'une ou l'autre. Les écritures monétaires acceptent un header `Idempotency-Key` pour la dé-duplication. ## Enveloppe de réponse Toutes les réponses suivent le format `{ ok: boolean, data?: T, error?: { code, message, details? } }`. ## Webhooks sortants Signature HMAC SHA-256 dans le header `X-KryptaPay-Signature`. Le secret est défini à la création de l'endpoint. version: 1.0.0 contact: name: KryptaPay Support email: support@kryptapay.test url: https://kryptapay.test license: name: Proprietary servers: - url: http://localhost description: Local dev security: - bearerAuth: [] - cookieAuth: [] tags: - name: wallets description: Portefeuilles fiat / stablecoin / IBAN virtuels - name: transactions description: Historique unifié des mouvements - name: payouts description: Versements Mobile Money / banque / stablecoin - name: payins description: Encaissements et liens de paiement - name: fx description: Cotations et conversions multi-devises - name: counterparties description: Bénéficiaires et tiers - name: invoices description: Factures + paiement public + reçus - name: status description: Statut public des services paths: /v1/deposits/: post: tags: - deposits summary: Declare a manual deposit with proof requestBody: content: application/json: schema: type: object properties: channel: type: string enum: - BANK - MOBILE_MONEY - CRYPTO currency: type: string enum: - XOF - XAF - NGN - GHS - CDF - EUR - USD - USDC - USDT declaredAmount: type: string pattern: ^\d+(\.\d{1,8})?$ description: >- Decimal amount with up to 8 fractional digits, e.g. "1500" or "1500.75" bankName: type: string maxLength: 160 payerName: type: string maxLength: 180 payerPhone: type: string maxLength: 32 network: type: string enum: - MTN_BJ - MTN_CI - MTN_CM - ORANGE_CI - ORANGE_SN - ORANGE_ML - ORANGE_BF - ORANGE_CM - MOOV_BJ - MOOV_TG - MOOV_CI - MOOV_BF - WAVE_CI - WAVE_SN - FREE_SN - TMONEY_TG - MOBICASH_ML - MOBICASH_BF - DJAMO_CI - MIXX_SN - MTN_CG - AIRTEL_CG - ORANGE_CD - AIRTEL_CD - VODACOM_CD - AFRICELL_CD - AIRTEL_GA - MOMO_NG - AIRTEL_NG - MTN_GH - VODAFONE_GH - AIRTELTIGO_GH - BANK_XOF - BANK_XAF - BANK_NGN - BANK_GHS - BANK_CDF - BANK_EUR - BANK_USD - ETH - POLYGON - TRON txHash: type: string maxLength: 120 proof: type: object properties: filename: type: string minLength: 1 maxLength: 200 mimeType: type: string minLength: 3 maxLength: 120 base64: type: string minLength: 1 required: - filename - mimeType - base64 additionalProperties: false required: - channel - currency - declaredAmount additionalProperties: false required: true responses: '201': description: Default Response content: application/json: schema: type: object properties: ok: type: boolean enum: - true data: type: object properties: id: type: string reference: type: string ticketRef: type: string channel: type: string enum: - BANK - MOBILE_MONEY - CRYPTO currency: type: string enum: - XOF - XAF - NGN - GHS - CDF - EUR - USD - USDC - USDT declaredAmount: type: string pattern: ^\d+(\.\d{1,8})?$ description: >- Decimal amount with up to 8 fractional digits, e.g. "1500" or "1500.75" status: type: string enum: - PENDING - APPROVED - REJECTED - INFO_REQUESTED bankName: type: string nullable: true payerName: type: string nullable: true payerPhone: type: string nullable: true network: type: string enum: - MTN_BJ - MTN_CI - MTN_CM - ORANGE_CI - ORANGE_SN - ORANGE_ML - ORANGE_BF - ORANGE_CM - MOOV_BJ - MOOV_TG - MOOV_CI - MOOV_BF - WAVE_CI - WAVE_SN - FREE_SN - TMONEY_TG - MOBICASH_ML - MOBICASH_BF - DJAMO_CI - MIXX_SN - MTN_CG - AIRTEL_CG - ORANGE_CD - AIRTEL_CD - VODACOM_CD - AFRICELL_CD - AIRTEL_GA - MOMO_NG - AIRTEL_NG - MTN_GH - VODAFONE_GH - AIRTELTIGO_GH - BANK_XOF - BANK_XAF - BANK_NGN - BANK_GHS - BANK_CDF - BANK_EUR - BANK_USD - ETH - POLYGON - TRON nullable: true txHash: type: string nullable: true hasProof: type: boolean confirmedAmount: type: string pattern: ^\d+(\.\d{1,8})?$ description: >- Decimal amount with up to 8 fractional digits, e.g. "1500" or "1500.75" nullable: true decisionNote: type: string nullable: true reviewedAt: type: string nullable: true createdAt: type: string required: - id - reference - ticketRef - channel - currency - declaredAmount - status - bankName - payerName - payerPhone - network - txHash - hasProof - confirmedAmount - decisionNote - reviewedAt - createdAt additionalProperties: false required: - ok - data additionalProperties: false '401': description: Authentication required content: application/json: schema: type: object properties: ok: type: boolean enum: - false error: type: object properties: code: type: string message: type: string details: {} required: - code - message additionalProperties: false required: - ok - error additionalProperties: false description: Authentication required '403': description: Forbidden — no org / role / KYB content: application/json: schema: type: object properties: ok: type: boolean enum: - false error: type: object properties: code: type: string message: type: string details: {} required: - code - message additionalProperties: false required: - ok - error additionalProperties: false description: Forbidden — no org / role / KYB '422': description: Validation error or business-rule violation content: application/json: schema: type: object properties: ok: type: boolean enum: - false error: type: object properties: code: type: string message: type: string details: {} required: - code - message additionalProperties: false required: - ok - error additionalProperties: false description: Validation error or business-rule violation components: securitySchemes: bearerAuth: type: http scheme: bearer bearerFormat: JWT description: JWT utilisateur ou clé API `kp__xxx` cookieAuth: type: apiKey in: cookie name: kp_token description: Session signée (front Next.js) ````