# Paypal

* [Comment configurer PayPal ](#how-to-set-up-paypal)
* [Comment créer un lien de paiement ](#how-to-create-a-payment-link)
* [Comment traiter le résultat](#how-to-process-the-result)

## Comment configurer PayPal&#x20;

Pour utiliser PayPal, vous devez obtenir deux clés : client\_id et secret&#x20;

Allez sur la page[ https://developer.paypal.com/developer/applications/ ](< https://developer.paypal.com/developer/applications/ >)

Et choisissez dans la liste ou créez une nouvelle application :

![](/files/0a7b84996a3f8f76cf16c0b3d9bfce4b69a07ce6)

En haut, passez l'interrupteur en mode Live et sélectionnez l'application souhaitée. Une page de paramètres s'ouvre, où vous pouvez trouver les données recherchées :

![](/files/533cd358cd171687194c7657d6d11385b554ed19)

Copiez les données et collez-les dans les champs correspondants dans les paramètres Salebot - Systèmes de paiement - Paypal :

&#x20;                                             ![](/files/a1f1f776008bea6dd94dbf5d999810bbd19fa32a)

![](/files/32740e486fd341de11a73812e582d352ed3ba716)

C'est la fin de la connexion.

## Comment créer un lien de paiement&#x20;

Pour générer un lien de paiement, vous devez définir la valeur de la variable payment\_sum et la variable paypal\_pay\_url apparaît immédiatement.&#x20;

payment\_title n'est pas une variable obligatoire, c'est le nom du produit. Si vous ne la spécifiez pas, elle est remplie avec le texte : « Paiement compte order\_id » (order\_id - identifiant de commande sur le serveur)&#x20;

payment\_description - description du produit, facultative&#x20;

De plus, avant de spécifier payment\_sum, vous pouvez indiquer dans quelle langue sera la page de paiement. Pour cela, vous devez définir la variable locale, la valeur par défaut est le russe (ru-RU). Toutes les options possibles : **da-DK, he-IL, id-ID, ja-JP, no-NO, pt-BR, ru-RU, sv-SE, th-TH, zh-CN, zh-HK, zh-TW.**&#x20;

Et le troisième paramètre supplémentaire est company\_name - le nom de votre entreprise, affiché tout en haut de la page (exemple ci-dessous, entreprise).

&#x20;                                       &#x20;

Vous pouvez également spécifier la devise dans laquelle le paiement est accepté, pour cela nous indiquons la variable currency, la valeur par défaut est le rouble (RUB), pour le dollar définissez sa valeur à USD (currency = USD). Les variantes de devise possibles se trouvent sous le lien [https://developer.paypal.com/docs/api/reference/currency-codes/ ](<https://developer.paypal.com/docs/api/reference/currency-codes/ >)

Et le troisième paramètre supplémentaire est company\_name - le nom de votre entreprise, affiché tout en haut de la page (exemple ci-dessous, entreprise )&#x20;

La variable paypal\_pay\_url peut être affichée avec un lien ou placée sur le bouton « Payer ».&#x20;

Le lien a la forme : [https://ww.paypal.com/checkoutnow?token=07N53571YM296381N ](<https://ww.paypal.com/checkoutnow?token=07N53571YM296381N >)

Exemple d'implémentation.&#x20;

Définissez le montant du paiement à 444 et le nom de l'entreprise

&#x20;                                       ![](/files/dbec1bdf5c05a3ec80db78e50c0cdd6a1d8776c9)

{% hint style="info" %}
**Remarque :** la variable payment\_sum est définie comme la dernière variable, après la variable facultative **payment\_title**, **company\_name**, etc.
{% endhint %}

## Comment traiter le résultat

{% hint style="info" %}
Après un paiement réussi dans le bot, des kolbeks arriveront, grâce auxquels vous pourrez comprendre qu'un paiement a été effectué avec succès. Ces colbacks dans le système apparaissent comme des messages de l'utilisateur, de sorte qu'ils ne peuvent pas être envoyés par l'utilisateur ; ils se composent des 10 premiers symboles secrets et d'un indicateur d'état, par exemple : EHsWHYOoWV\_success.
{% endhint %}

De plus, après un paiement réussi, la variable paypal\_payment\_completed est définie sur True.

{% hint style="success" %}
Ces callbacks NE SONT PAS visibles pour l'utilisateur, ils sont affichés uniquement à l'opérateur.
{% endhint %}

{% hint style="danger" %}
Le type de comparaison doit être « Correspondance exacte »
{% endhint %}

{% hint style="warning" %}
Pour effectuer un paiement répété, vous devez réinitialiser payment\_sum, le lien généré précédemment, puis, après avoir réinitialisé la variable payment\_sum, obtenir un nouveau lien. Vous pouvez spécifier une valeur précédente.
{% endhint %}

{% hint style="warning" %}
Les callbacks arrivent avec un délai, donc après le lien vers le paiement de l'utilisateur, nous recommandons d'envoyer un message du type : « Après le paiement, attendez le message confirmant la réussite du paiement »
{% endhint %}

Par exemple, vous pouvez créer un bloc de traitement d'un paiement réussi avec une condition et afficher le message correspondant à l'utilisateur :

![](/files/0e9bdcb0d18d2b2affe9d753b29d3b2c7709e8ae)

Le type de comparaison doit être « Correspondance exacte »&#x20;

À la fin du paiement, le **paypal\_callback\_data** la variable sera ajoutée au client, contenant les données de réponse du système de paiement pour la transaction terminée. Vous pouvez extraire les données nécessaires du dictionnaire en utilisant le **get** .


---

# 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://docs.mavibot.ai/doc/fr/integrations/payment/paypal.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.
