> ## 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.

# Vérification NUBAN

> Résolvez un numéro de compte bancaire nigérian vers son nom de compte enregistré et sa banque.

L'endpoint NUBAN vérifie un Numéro de Compte Bancaire Uniforme Nigérian (NUBAN) et renvoie le nom de compte et la banque associés. Utilisez-le pour la vérification de la propriété du compte bancaire lors de l'intégration ou des flux de paiement.

## Endpoint

```
POST /api/onboarding/nigeria_kyc/nuban/
```

## 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                                                |
| ---------------- | ------ | ------ | ---------------------------------------------------------- |
| `account_number` | string | Oui    | Le numéro de compte NUBAN à 10 chiffres                    |
| `bank_code`      | string | Oui    | Le code bancaire à 3–6 chiffres (voir la liste ci-dessous) |

### Exemple

<CodeGroup>
  ```bash cURL theme={null}
  curl -X POST "https://adhere-api.smartcomply.com/api/onboarding/nigeria_kyc/nuban/" \
    -H "x-access-token: YOUR_SECRET_KEY" \
    -H "Content-Type: application/json" \
    -d '{"account_number": "0768540312", "bank_code": "035"}'
  ```

  ```python Python theme={null}
  import requests
  response = requests.post(
      "https://adhere-api.smartcomply.com/api/onboarding/nigeria_kyc/nuban/",
      headers={"x-access-token": "YOUR_SECRET_KEY", "Content-Type": "application/json"},
      json={"account_number": "0768540312", "bank_code": "035"},
  )
  ```
</CodeGroup>

### Référence des codes bancaires

<Accordion title="Voir tous les codes bancaires pris en charge">
  | Banque                       | Code     |
  | ---------------------------- | -------- |
  | Access Bank                  | `044`    |
  | Citibank Nigeria             | `023`    |
  | ECOBANK                      | `050`    |
  | FCMB                         | `214`    |
  | Fidelity Bank                | `070`    |
  | First Bank of Nigeria        | `011`    |
  | GTBank                       | `058`    |
  | Heritage Bank                | `030`    |
  | JAIZ Bank                    | `301`    |
  | Kuda Microfinance Bank       | `50211`  |
  | Lotus Bank                   | `303`    |
  | Moniepoint Microfinance Bank | `50563`  |
  | Opay                         | `999992` |
  | Palmpay                      | `999111` |
  | Polaris Bank                 | `076`    |
  | Providus Bank                | `101`    |
  | Stanbic IBTC Bank            | `221`    |
  | Standard Chartered Bank      | `068`    |
  | Sterling Bank                | `232`    |
  | TAJBank                      | `302`    |
  | Union Bank of Nigeria        | `032`    |
  | United Bank For Africa       | `033`    |
  | Unity Bank                   | `215`    |
  | Wema Bank                    | `035`    |
  | Zenith Bank                  | `057`    |
</Accordion>

## Réponse

### 200 OK

| Champ                 | Type    | Description                           |
| --------------------- | ------- | ------------------------------------- |
| `data.bank_id`        | integer | Identifiant bancaire interne          |
| `data.account_name`   | string  | Nom du titulaire du compte enregistré |
| `data.account_number` | string  | Numéro de compte interrogé            |

```json theme={null}
{
  "status": "success",
  "data": {
    "bank_id": 11,
    "account_name": "STEPHEN BADMUS",
    "account_number": "0768540312"
  },
  "message": "Nuban 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/nigeria_kyc/nuban/
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/nigeria_kyc/nuban/:
    post:
      tags:
        - Nigeria KYC
      summary: NUBAN Verification
      operationId: nuban
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
                - account_number
                - bank_code
              properties:
                account_number:
                  type: string
                  description: 10-digit account number
                  example: '0123456789'
                bank_code:
                  type: string
                  example: '044'
      responses:
        '200':
          description: NUBAN 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

````