> ## 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. # Create a payin checkout link ## OpenAPI ````yaml /openapi.json post /v1/payins/checkout 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/payins/checkout: post: tags: - payins summary: Create a payin checkout link requestBody: content: application/json: schema: type: object properties: amount: type: string pattern: ^\d+(\.\d{1,8})?$ description: >- Decimal amount with up to 8 fractional digits, e.g. "1500" or "1500.75" currency: type: string enum: - XOF - XAF - NGN - GHS - CDF - EUR - USD - USDC - USDT 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 customer: type: object properties: fullName: type: string maxLength: 180 msisdn: type: string minLength: 8 maxLength: 20 email: type: string format: email additionalProperties: false redirectUrl: type: string format: uri expiresInSec: type: integer minimum: 60 maximum: 86400 required: - amount - currency - customer 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: reference: type: string status: type: string enum: - PENDING - PROCESSING - COMPLETED - FAILED - CANCELLED - REFUNDED amount: type: string pattern: ^\d+(\.\d{1,8})?$ description: >- Decimal amount with up to 8 fractional digits, e.g. "1500" or "1500.75" currency: type: string enum: - XOF - XAF - NGN - GHS - CDF - EUR - USD - USDC - USDT checkoutUrl: type: string nullable: true checkoutToken: type: string nullable: true expiresInSec: type: integer provider: type: string enum: - BRIDGE - PAL_AFRICA - MBIYOPAY - INTERNAL - PAYDUNYA - PAYFONTE providerMode: type: string enum: - live - mock - disabled required: - reference - status - amount - currency - checkoutUrl - checkoutToken - expiresInSec - provider - providerMode additionalProperties: false required: - ok - data additionalProperties: false '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) ````