# Callback

Une URL de rappel est une page de site web vers laquelle l'utilisateur est dirigé après une transaction réussie. Par exemple, sur un site de commerce électronique qui vend des étuis de téléphone et des bijoux, le client peut effectuer un achat par le biais de l'option de paiement prévue à cet effet. Une fois le processus de paiement terminé, le client est redirigé vers le site web, généralement vers une page qui confirme que sa commande a bien été reçue. Cette page est l'URL de rappel.

Du point de vue du client, une URL de rappel correctement configurée le redirige vers la page que vous avez spécifiée une fois la transaction terminée, généralement une page de confirmation de la commande.

Exemples d'utilisation des URL de rappel. Un client achète un article dans votre magasin en utilisant la méthode de redirection pour payer l'article. Une URL de rappel est utilisée pour renvoyer le client sur votre site web afin qu'il puisse continuer à parcourir les articles. Vous possédez une application web de prise de rendez-vous qui intègre Paystack, vous pouvez rediriger un utilisateur vers votre compte Calendly pour qu'il réserve un créneau dans votre calendrier. Si vous possédez une librairie, vous pouvez mettre en place une URL de rappel qui redirige un client vers votre Google drive de livres une fois que le client a effectué son paiement.

## Etapes à suivre 

<figure><img src="/files/x5NrF0oauRAdho8LjBMq" alt=""><figcaption></figcaption></figure>

1. Allez dans les paramètres du tableau de bord du commerçant pour ajouter votre URL de rappel
2. Paramètres>Clé API & URL de rappel
3. Sélectionnez le compte, par exemple MTN benin ou MOOV benin, etc.
4. saisissez l'URL de rappel sécurisée
5. sauvegarder en cliquant sur le bouton de sauvegarde

URL de rappel valide :

1. Assurez-vous que l'URL ne redirige que vers un site HTTPS.
2. Assurez-vous que l'URL est un site web qui peut être chargé par un navigateur, par exemple <https://www.example.com>.
3. Assurez-vous de ne pas utiliser localhost comme URL de rappel, par exemple localhost://exemple.com ne fonctionnerait pas.

## Pour  le payload du callback, QOSPAY vous enverra le payload qui suis sur votre url validé

```
Transaction réussie 
```

```json
// Some code{
{
"status": "SUCCESSFUL",
  "transRef": "455855",
  "specialfield1": "SUCCESSFUL",
  "amount": "2000",
  "serviceRef": "14557856",
  "code": "200",
}

```

```
Échec de la transaction
```

```json
// 
{
  "status": "FAILED",
  "transRef": "455855",
  "specialfield1": "FAILED",
  "amount": "2000",
  "serviceRef": "14557856",
  "code": "-1",
}
```


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://qosic.gitbook.io/api-documentation/callback.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.