# Paypal

* [Como configurar o Paypal ](#how-to-set-up-paypal)
* [Como criar um link de pagamento ](#how-to-create-a-payment-link)
* [Como processar o resultado](#how-to-process-the-result)

## Como configurar o Paypal&#x20;

Para მუშაობar com o Paypal, você precisa obter duas chaves: client\_id e secret&#x20;

Vá para a página[ https://developer.paypal.com/developer/applications/ ](< https://developer.paypal.com/developer/applications/ >)

E escolha da lista ou crie uma nova aplicação:

![](/files/f855a59564377e4a58fa0b4aa0db8e2ae0666d85)

No topo, altere o botão para o modo Ao vivo e selecione a aplicação desejada. Abre uma página com as configurações onde você pode encontrar os dados que deseja:

![](/files/bbee3d63c732fad7eff4cc9dfb94dc9ff6475d98)

Copie os dados e cole-os nos campos correspondentes nas configurações do Salebot - Sistemas de Pagamento - Paypal:

&#x20;                                             ![](/files/82fbdcf11ada70ab54359a6dc2b9b6d18a90a4be)

![](/files/96b884b518f567e18b9daee56b2b95d342a9ea2a)

A conexão está concluída.

## Como criar um link de pagamento&#x20;

Para gerar um link de pagamento, você precisa definir o valor da variável payment\_sum e a variável paypal\_pay\_url aparece imediatamente.&#x20;

payment\_title não é uma variável obrigatória; é o nome do produto. Se você não especificar, será preenchida com o texto: "Pedido da conta de pagamento order\_id" (order\_id - identificador do pedido no servidor)&#x20;

payment\_description - descrição do produto, opcional&#x20;

Além disso, antes de especificar payment\_sum, você pode definir em qual idioma a página de pagamento estará. Para isso, você precisa definir a variável locale; o padrão é Russo (ru-RU). Todas as opções possíveis: **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;

E o terceiro parâmetro adicional é company\_name - o nome da sua empresa, exibido no topo da página (exemplo abaixo, empresa).

&#x20;                                       &#x20;

Você também pode especificar a moeda em que o pagamento é aceito; para isso, especificamos a variável currency. O padrão é configurado como rublo (RUB); para dólar, defina seu valor como USD (currency = USD). As variantes de moeda possíveis podem ser encontradas no link [https://developer.paypal.com/docs/api/reference/currency-codes/ ](<https://developer.paypal.com/docs/api/reference/currency-codes/ >)

E o terceiro parâmetro adicional é company\_name - o nome da sua empresa, exibido no topo da página (exemplo abaixo, empresa )&#x20;

A variável paypal\_pay\_url pode ser exibida com um link ou colocada no botão "Pagar".&#x20;

O link tem o formato: [https://ww.paypal.com/checkoutnow?token=07N53571YM296381N ](<https://ww.paypal.com/checkoutnow?token=07N53571YM296381N >)

Exemplo de implementação.&#x20;

Defina o valor do pagamento 444 e o nome da empresa

&#x20;                                       ![](/files/20690a0750338ce41a96468c2d1b00b1149ec4db)

{% hint style="info" %}
**Observação:** a variável payment\_sum é definida como a última variável, após a opcional **payment\_title**, **company\_name**, etc.
{% endhint %}

## Como processar o resultado

{% hint style="info" %}
Após o pagamento bem-sucedido no bot, chegarão callbacks, pelos quais você pode entender que houve um pagamento bem-sucedido. Esses callbacks no sistema são vistos como mensagens do usuário; portanto, para que não possam ser enviados pelo usuário, eles consistem nos 10 primeiros símbolos secretos e em uma página inicial com status, por exemplo: EHsWHYOoWV\_success.
{% endhint %}

Além disso, após o pagamento bem-sucedido, a variável paypal\_payment\_completed é definida como True.

{% hint style="success" %}
Esses callbacks NÃO SÃO VISTOS pelo usuário; eles são exibidos apenas para o operador.
{% endhint %}

{% hint style="danger" %}
O tipo de comparação deve ser "Correspondência exata"
{% endhint %}

{% hint style="warning" %}
Para fazer um pagamento повторado, você deve redefinir payment\_sum, o link gerado anteriormente e, depois de redefinir a variável payment\_sum, obter um novo link. Você pode especificar um valor anterior.
{% endhint %}

{% hint style="warning" %}
Os callbacks chegam com atraso, então, depois do link de pagamento para o usuário, recomendamos enviar uma mensagem como: "Após o pagamento, aguarde a mensagem sobre a conclusão bem-sucedida do pagamento"
{% endhint %}

Por exemplo, você pode criar um bloco de processamento de pagamento bem-sucedido com uma condição e exibir a mensagem correspondente ao usuário:

![](/files/06bc4156a771e14ad0a414eef0850478f09f43d7)

O tipo de comparação deve ser "Correspondência exata"&#x20;

Após a conclusão do pagamento, a **paypal\_callback\_data** variável será adicionada ao cliente, contendo os dados de resposta do sistema de pagamento para a transação concluída. Você pode extrair os dados necessários do dicionário usando a **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/pt/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.
