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

# Carte d'identité Ghana avancée

> Vérifiez l'identité d'un client à l'aide de son numéro de Carte d'identité Ghana accompagné d'une photo selfie.

L'endpoint Carte d'identité Ghana avancée vérifie l'identité d'un client en faisant correspondre son numéro de Carte d'identité Ghana avec une photo selfie soumise. Renvoie les détails personnels vérifiés et la photo de l'inscrit sur dossier.

## Endpoint

```
POST /api/onboarding/ghana_kyc/id_card_with_face/
```

## Requête

### En-têtes

| En-tête          | Valeur                | Requis |
| ---------------- | --------------------- | ------ |
| `x-access-token` | Votre clé secrète API | Oui    |
| `Content-Type`   | `application/json`    | Oui    |

### Paramètres de corps

| Paramètre               | Type   | Requis | Description                                                                |
| ----------------------- | ------ | ------ | -------------------------------------------------------------------------- |
| `identification_number` | string | Oui    | Le numéro de Carte d'identité Ghana du client (format : `GHA-000000000-0`) |
| `selfie_image`          | string | Oui    | Image selfie encodée en base64 pour la concordance faciale                 |

### Exemple

<CodeGroup>
  ```bash cURL theme={null}
  curl -X POST "https://adhere-api.smartcomply.com/api/onboarding/ghana_kyc/id_card_with_face/" \
    -H "x-access-token: YOUR_SECRET_KEY" \
    -H "Content-Type: application/json" \
    -d '{
      "identification_number": "GHA-000000000-0",
      "selfie_image": "<base64-encoded-jpeg>"
    }'
  ```
</CodeGroup>

## Réponse

### 200 OK

| Champ                      | Type   | Description                                               |
| -------------------------- | ------ | --------------------------------------------------------- |
| `data.FullName`            | string | Nom complet                                               |
| `data.FirstName`           | string | Prénom                                                    |
| `data.LastName`            | string | Nom de famille                                            |
| `data.DOB`                 | string | Date de naissance                                         |
| `data.Gender`              | string | Genre                                                     |
| `data.Address`             | string | Adresse enregistrée                                       |
| `data.Photo`               | string | Photo du client encodée en base64                         |
| `data.FaceMatchStatus`     | string | Statut de concordance faciale (`"MATCH"` ou `"NO_MATCH"`) |
| `data.FaceMatchConfidence` | number | Score de confiance de correspondance (0–100)              |

```json theme={null}
{
  "status": "success",
  "data": {
    "FullName": "JOHN DOE",
    "FirstName": "JOHN",
    "LastName": "DOE",
    "DOB": "1990-01-15",
    "Gender": "Male",
    "Address": "ACCRA",
    "Photo": "<base64-encoded-jpeg>",
    "FaceMatchStatus": "MATCH",
    "FaceMatchConfidence": 99.5
  },
  "message": "ID Card and Face Match details retrieved successfully"
}
```

### 400 Bad Request

```json theme={null}
{
  "status": "failed",
  "data": [],
  "message": "Sorry, your check cannot be processed at the moment. Please try again in a few minutes"
}
```

### 401 Unauthorized

```json theme={null}
{
  "status": "failed",
  "message": "Authentication credentials were not provided."
}
```


## OpenAPI

````yaml POST /api/onboarding/ghana_kyc/id_card_with_face/
openapi: 3.0.3
info:
  title: Adhere API
  description: >-
    Identity verification, credit checks, transaction monitoring, and loan fraud
    detection across Africa.
  version: 3.0.0
servers:
  - url: https://adhere-api.smartcomply.com
    description: Production
security:
  - ApiKeyAuth: []
tags:
  - name: Nigeria KYC
  - name: Kenya KYC
  - name: Ghana KYC
  - name: Rwanda KYC
  - name: Uganda KYC
  - name: Document Verification
  - name: Biometrics
  - name: Individual Credit
  - name: Business Credit
  - name: Transaction Monitoring
  - name: Transaction Screening
  - name: Transaction KYC
  - name: Loan Fraud
  - name: User Journey
paths:
  /api/onboarding/ghana_kyc/id_card_with_face/:
    post:
      tags:
        - Ghana KYC
      summary: Ghana ID Card with Face
      operationId: ghanaIdCardWithFace
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
                - identification_number
                - selfie_image
              properties:
                identification_number:
                  type: string
                  description: Ghana Card number
                selfie_image:
                  type: string
                  description: Base64-encoded selfie image
      responses:
        '200':
          description: ID card with face verified
        '400':
          $ref: '#/components/responses/BadRequest'
        '401':
          $ref: '#/components/responses/Unauthorized'
components:
  responses:
    BadRequest:
      description: Bad Request
      content:
        application/json:
          schema:
            type: object
            properties:
              status:
                type: string
                example: failed
              data:
                type: array
                items: {}
              message:
                type: string
    Unauthorized:
      description: Unauthorized
      content:
        application/json:
          schema:
            type: object
            properties:
              status:
                type: string
                example: failed
              message:
                type: string
                example: Authentication credentials were not provided.
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: x-access-token
      description: Your Adhere API secret key

````