Como Configurar o Paypal
Para trabalhar com o Paypal, você precisa obter duas chaves: client_id e secret
Acesse a página https://developer.paypal.com/developer/applications/
E escolha na lista ou crie um novo aplicativo:
No topo, alterne para o modo Live e selecione o aplicativo desejado. Abre uma página com as configurações onde você pode encontrar os dados desejados:
Copie os dados e cole nos campos correspondentes nas configurações do Salebot - Sistemas de Pagamento - Paypal:
Isso conclui a conexão.
Como Criar um Link de Pagamento
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.
payment_title não é uma variável obrigatória, é o nome do produto. Se não for especificada, é preenchida com o texto: "Pagamento do pedido order_id" (order_id - identificador do pedido no servidor)
payment_description - descrição do produto, opcional
Além disso, antes de especificar payment_sum, você pode definir em qual idioma a página de pagamento será exibida. Para isso, é necessário 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.
E o terceiro parâmetro adicional é company_name - o nome da sua empresa, exibido no topo da página (exemplo abaixo, empresa).
Você também pode especificar a moeda na qual o pagamento é aceito, para isso definimos a variável currency, o padrão é definido como rublo (RUB), para o 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/
E o terceiro parâmetro adicional é company_name - o nome da sua empresa, exibido no topo da página (exemplo abaixo, empresa )
A variável paypal_pay_url pode ser exibida com um link ou colocada no botão "Pagar".
O link tem a forma: https://ww.paypal.com/checkoutnow?token=07N53571YM296381N
Exemplo de implementação.
Defina o valor do pagamento 444 e o nome da empresa
Nota: a variável payment_sum é definida como a última variável, após as opcionais payment_title, company_name, etc.
Como processar o resultado
Após o pagamento bem-sucedido, chegarão callbacks no bot, pelos quais você pode entender que houve um pagamento bem-sucedido. Esses callbacks no sistema são vistos como mensagens do usuário, para que não possam ser enviados pelo usuário, eles consistem nos primeiros 10 símbolos secretos e uma homepage com status, por exemplo: EHsWHYOoWV_success.
Além disso, após o pagamento bem-sucedido, a variável paypal_payment_completed é definida como True.
Esses callbacks NÃO SÃO VISÍVEIS para o usuário, eles são exibidos apenas para o operador.
O tipo de comparação deve ser "Correspondência exata"
Para fazer um pagamento repetido, você deve redefinir o payment_sum, o link gerado anteriormente e, após redefinir a variável payment_sum, obter um novo link. Você pode especificar um valor anterior.
Os callbacks chegam com atraso, portanto, após o link para o pagamento do usuário, recomendamos enviar uma mensagem do tipo: "Após o pagamento, aguarde a mensagem sobre a conclusão bem-sucedida do pagamento"
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:
O tipo de comparação deve ser "Correspondência exata"
Após a conclusão do pagamento, a variável paypal_callback_data 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 o método get.