> ## Documentation Index
> Fetch the complete documentation index at: https://docs.alphapay.me/llms.txt
> Use this file to discover all available pages before exploring further.

# Consulter mes tarifs

> Tarif applicable réseau par réseau, et si un OTP pré-paiement est requis avant de payer

<Note>
  `otp_required` suit la route actuellement la plus prioritaire pour ce réseau. S'il redevient `false` plus tard sans rien changer de votre côté, c'est qu'un autre fournisseur sans OTP a repris la main sur ce réseau — pas une anomalie.
</Note>

<Info>
  `is_custom: true` signifie que ce tarif vous est propre (négocié), par opposition au tarif global appliqué par défaut à tous les marchands.
</Info>


## OpenAPI

````yaml api-reference/openapi.json GET /pricing/my-rates/
openapi: 3.1.0
info:
  title: AlphaPay API
  description: >-
    API d'encaissement et de paiement mobile money/carte pour l'Afrique de
    l'Ouest et du Centre. Toutes les routes marchand nécessitent une clé API
    secrète (header Authorization: Bearer sk_...).
  version: 1.0.0
servers:
  - url: https://api.alphapay.me/api/v1
security:
  - bearerAuth: []
paths:
  /pricing/my-rates/:
    get:
      tags:
        - Référentiels
      summary: Consulter mes tarifs et disponibilités par réseau
      description: >-
        Pour chaque (pays, réseau) actif, le tarif payin/payout réellement
        applicable à vous aujourd'hui, déjà résolu (réseau + marge combinés en
        un seul total, jamais l'identité du gateway derrière ni la
        décomposition). Utilisez `otp_required`/`otp_instructions` pour savoir,
        avant d'appeler POST /payments/softpay/, si ce réseau exige un OTP
        pré-paiement (voir la section OTP pré-paiement de la page Paiements).
      parameters:
        - name: merchant
          in: query
          required: false
          schema:
            type: string
            format: uuid
          description: >-
            UUID du marchand visé. Ignoré pour une clé API (toujours vous-même)
            ; pour un token dashboard gérant plusieurs marchands, résout la
            boutique visée si le header X-Merchant-Id n'est pas fourni.
      responses:
        '200':
          description: >-
            Un objet par (pays, réseau) où au moins un sens (payin ou payout)
            est disponible
          content:
            application/json:
              example:
                - country_code: CI
                  country_name: Côte d'Ivoire
                  currency: XOF
                  network_code: orange_ci
                  network_name: Orange Money
                  payin:
                    available: true
                    is_custom: false
                    otp_required: true
                    otp_instructions: >-
                      Sur votre téléphone, composez #144*82# puis choisissez
                      l'option 2 pour obtenir votre code de paiement.
                    tiers:
                      - min_amount: '0.00'
                        max_amount: '500000.00'
                        currency: XOF
                        percent: '2.500'
                        fixed: '0.00'
                        floor_amount: '50.00'
                        cap_amount: null
                        fee_charge_mode: ADD_ON
                  payout:
                    available: true
                    is_custom: false
                    otp_required: false
                    otp_instructions: ''
                    tiers:
                      - min_amount: '0.00'
                        max_amount: '500000.00'
                        currency: XOF
                        percent: '1.800'
                        fixed: '0.00'
                        floor_amount: null
                        cap_amount: '5000.00'
                        fee_charge_mode: DEDUCTED
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: sk_live_... / sk_test_...
      description: >-
        Clé API secrète du marchand — header Authorization: Bearer sk_live_xxx
        (ou sk_test_xxx en environnement de test).

````