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

# Verifier un numero de telephone

> Validates a mobile number through the public gateway, detects its country when the international format allows it, and returns the national wallet expected by SoleasPay providers.



## OpenAPI

````yaml POST /phone-numbers/verify
openapi: 3.1.0
info:
  title: Mysoleas API
  version: 3.0.0
  description: >-
    Nouvelle architecture Mysoleas: gateway metier, Mysoleas Identity Cloud et
    ecosysteme SoleasPay.
servers:
  - url: https://api.mysoleas.com
    description: Gateway Mysoleas
  - url: https://account.mysoleas.com
    description: Authentification Mysoleas
security:
  - spAuthToken: []
tags:
  - name: Identity Cloud
  - name: Plugin
  - name: Payment links
  - name: Subscriptions
  - name: Collections
  - name: Disbursements
  - name: Verification
  - name: Catalog
paths:
  /phone-numbers/verify:
    post:
      tags:
        - Verification
      summary: Verifier un numero de telephone
      description: >-
        Valide un numero mobile via la gateway publique, detecte son pays
        lorsque le format international le permet et retourne le wallet national
        attendu par les providers SoleasPay.
      operationId: verifyPhoneNumber
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                wallet:
                  type: string
                  description: Numero ou wallet client a verifier.
                phone_number:
                  type: string
                  description: Alias de `wallet`.
                phone:
                  type: string
                  description: Alias de `wallet`.
                country:
                  type: string
                  description: >-
                    Pays attendu en ISO alpha-3, par exemple `CMR`. Requis pour
                    un numero national ou un indicatif colle sans `+` ni `00`.
              oneOf:
                - required:
                    - wallet
                - required:
                    - phone_number
                - required:
                    - phone
            examples:
              national:
                summary: Numero national avec pays
                value:
                  wallet: '650020109'
                  country: CMR
              international:
                summary: Numero international auto-detectable
                value:
                  phone_number: '+237650020109'
              callingCodeWithoutPlus:
                summary: Indicatif colle avec pays
                value:
                  wallet: '237650020109'
                  country: CMR
      responses:
        '200':
          description: Numero valide.
          content:
            application/json:
              example:
                code: 200
                success: true
                data:
                  valid: true
                  country:
                    alpha2: CM
                    alpha3: CMR
                    calling_code: '237'
                  number:
                    e164: '+237650020109'
                    international: +237 6 50 02 01 09
                    national: '650020109'
                    provider_wallet: '650020109'
                  type: MOBILE
                  operator: MTN Cameroon
                  supported_country: true
                  support_message: null
                locale: fr
                message: Numero de telephone verifie.
        '400':
          description: Numero invalide, pays manquant ou pays incoherent.
          content:
            application/json:
              examples:
                countryRequired:
                  value:
                    success: false
                    code: 400
                    message: phone_country_required
                invalidPhoneCountry:
                  value:
                    success: false
                    code: 400
                    message: invalid_phone_country
        '401':
          description: API key manquante ou invalide.
      security:
        - merchantApiKey: []
components:
  securitySchemes:
    spAuthToken:
      type: apiKey
      in: header
      name: x-sp-auth-token
      description: >-
        JWT Bearer emis par Mysoleas Identity Cloud. Format: Bearer
        <access_token>.
    merchantApiKey:
      type: apiKey
      in: header
      name: X-API-Key
      description: >-
        API key marchand SoleasPay. Utilisee pour les endpoints publics plugin
        ou verification telephone.

````