> For the complete documentation index, see [llms.txt](https://qosic.gitbook.io/qospay/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://qosic.gitbook.io/qospay/merchant-api/authentication/reset-client-secret.md).

# reset client secret

Cette opération renouvelle le secret du marchand authentifié et est obligatoire avant le passage en production.

```http
POST /api/v1/auth/reset HTTP/1.1
Host: api.example.com
Authorization: Bearer <access-token>
Accept: application/json
Content-Length: 0
```

Requête cURL équivalente :

```bash
curl --request POST "https://api.example.com/api/v1/auth/reset" \
  --header "Authorization: Bearer ${QOS_ACCESS_TOKEN}" \
  --header "Accept: application/json"
```

Cette requête ne contient aucun body.

### Réponse réussie — HTTP 200

```json
{
  "data": null,
  "message": "Client secret reset successfully",
  "success": true,
  "responseCode": "00"
}
```

Le nouveau secret est envoyé à l’adresse e-mail enregistrée du marchand ; il n’est pas renvoyé dans la réponse API.

{% stepper %}
{% step %}

## Récupérez le nouveau secret

Récupérez le nouveau secret dans la boîte e-mail enregistrée.
{% endstep %}

{% step %}

## Remplacez l’ancien secret

Remplacez l’ancien secret dans votre gestionnaire de secrets.
{% endstep %}

{% step %}

## Vérifiez une nouvelle connexion

Vérifiez qu’une nouvelle connexion fonctionne avec le nouveau secret.
{% endstep %}

{% step %}

## Supprimez l’ancien secret

Supprimez l’ancien secret de la configuration, des variables CI/CD et des fichiers de développement locaux.
{% endstep %}
{% endstepper %}

{% hint style="warning" %}
L’ancien secret client ne peut plus être utilisé pour une nouvelle connexion. Un token bearer émis avant la rotation reste utilisable jusqu’à son expiration ; protégez donc ou révoquez l’accès de tout système qui le détenait.
{% endhint %}

### Réponse en échec — HTTP 400

```json
{
  "data": null,
  "message": "Could not reset client secret",
  "success": false,
  "responseCode": "400"
}
```

{% hint style="warning" %}
Ne renouvelez pas le secret de manière répétitive. Vérifiez la boîte e-mail enregistrée et ne réessayez qu’une seule fois si l’opération a clairement échoué. `Merchant not found` indique un contexte de sécurité marchand invalide ou obsolète ; obtenez un nouveau token et réessayez.
{% endhint %}