Configurando pagamentos no builder do Blip Raphael.xisto 23 de junho de 2022 19:00 Atualizado Esta funcionalidade está em beta. Quer ter acesso antecipado? Inscreva-se para testá-la antes do lançamento oficial! Índice: Pagamentos no Builder Pagamento por página web (Cartão de crédito/débito e boleto) Pagamento automático (Card on file) Pagamentos no Builder Para utilizar pagamentos no builder é necessário utilizar a ação de processar comandos para o envio de comandos de pagamentos. Essa ação pode ser adicionada nas ações de entrada ou de saída do bloco conforme desejado. Conforme mencionado acima, existem diferentes tipos de pagamentos. Para cada pagamento precisamos preencher a ação de processar comando de uma forma diferente, que será apresentada a seguir. Pagamento por página web (Cartão de crédito/débito e boleto) Preliminarmente, é importante comentar que a forma de pagamento via página web integra o pagamento Session do Stripe e a título de exemplificação será apresentado apenas parte dos dados que podem ser informados para gerar esse tipo de pagamento. Para mais detalhes, acesse a documentação do Stripe. Segue abaixo um referencial dos dados a ser preenchidos neste comando é um exemplo do resource a ser enviado: Para: postmaster@stripe.msging.net Método: set URI: /payment/{{contact.identity}}/session Tipo: application/json Resource: { "paymentMethodTypes": [ "card", "boleto" ], "lineItems": [ { "amount": 50000, "currency": "brl", "description": "Curso do Blip - Fornecido pela Take Blip", "images": [ "https://www.take.net/files/themes/blank_theme/assets/img/take-og-image.png" ], "name": "Curso do Blip - Módulo de Pagamentos", "quantity": 1 }, { "amount": 20000, "currency": "brl", "description": "Curso do Blip - Fornecido pela Take Blip", "images": [ "https://www.take.net/files/themes/blank_theme/assets/img/take-og-image.png" ], "name": "Curso do Blip - Módulo de Catálogo", "quantity": 1 } ], "paymentIntentData": {"setupFutureUsage": "on_session"}, "successUrl": "https://www.take.net", "cancelUrl": "https://www.take.net" } Cada campo do item "Resource" possui uma função importante na geração deste tipo de pagamento, veja seguir o que cada campo representa neste exemplo de resource. Vale lembrar que conforme citado anteriormente é possível utilizar mais campos para customizar seu pagamento conforme desejado, para mais detalhes acesse a documentação do Stripe. Campos do Resource Descrição paymentMethodTypes Tipo de pagamento lineItems Itens que serão adquiridos acompanhados dos seus respectivos preços, imagens, nome, quantidade. successUrl Url do site que o usuário será redirecionado após pagamento estiver completo cancelUrl Url do site que o usuário será redirecionado se o pagamento for cancelado paymentIntendData.setupFutureUsage Dado necessário para salvar dados do cartão usado no link de pagamento para uso futuro (Pagamento Card on File). Neste caso, o usuário será informado na tela de checkout que, ao fechar o pagamento, permitirá que a marca armazene os dados deste pagamento para uso futuro. Atenção: A interface do Stripe não permite que o usuário opte por salvar o cartão durante o checkout. Isto deve ser feito durante a geração do link, uma vez que o parâmetro usado ao gerar o link determina se o cartão será salvo ou não. Por isso, é importante que o processo de opção do usuário por salvar ou não o cartão seja feito no bot, no momento da geração do link. A propriedade “setupFutureUsage” permite dois valores: “on_session” e “off_session”. Para entender melhor a diferença entre eles, consulte a documentação do stripe. Veja um exemplo da ação configurada para este tipo de pagamento: Ao fim deste processo, caso o contato faça o pagamento com sucesso, será adicionado o seu stripeCustomerId (ID de cliente do Stripe) nas suas informações extras. Assim sendo, o valor do stripeCustomerId precisar ser informado em futuros pagamentos com intuito de manter o contexto de pagamento único e atualizado por contato. Veja abaixo um exemplo desta informação vinculada ao contato: Pagamento automático (Card on file) Para efetuar esse tipo pagamento o contato deve já ter previamente realizado um pagamento por página web e salvado o cartão para compras futuras. Uma forma de validar se um contato concluiu esta etapa é verificando se o “stripeCustomerId” está presente nos extras das informações do mesmo. Analogamente, vale ressaltar que a forma de pagamento automático (Card on file) integra o pagamento Payment Intent do Stripe e a título de exemplificação será apresentado apenas parte dos dados que podem ser informados para gerar esse tipo de pagamento. Para mais detalhes, acesse a documentação do Stripe. Segue abaixo um referencial dos dados a ser preenchidos neste comando e um exemplo do resource a ser enviado: Para: postmaster@stripe.msging.net Método: set URI: /payment/{{contact.identity}}/payment-intent Tipo: application/json Resource: { "customer": "{{contact.extras.stripeCustomerId}}", "paymentMethodTypes": ["card"], "amount":1000, "currency":"brl", "confirm":"true", "paymentMethod":"card_1JAJVLAPY5jzkF510JNLqwGL"} Cada campo do item "Resource" possui uma função importante na geração deste tipo de pagamento, veja seguir o que cada campo representa neste exemplo de resource. Vale lembrar que conforme citado anteriormente é possível utilizar mais campos para customizar seu pagamento conforme desejado, para mais detalhes acesse a documentação do Stripe. Campos do Resource Descrição customer Identificador do customer paymentMethodTypes Tipo de pagamento amount Valor a ser pago currency Código da moeda de três letras. confirm Confirmar o pagamento automaticamente após ser pago. paymentMethod (Opcional) Identificador do cartão que será realizado o pagamento. Caso não informado, o pagamento será realizado no cartão padrão. (busque e selecione cartões cadastrados através deste endpoint ) https://docs.blip.ai/#payment-methods Veja um exemplo da ação configurada para este tipo de pagamento: Para mais informações, acesse a discussão sobre o assunto em nossa comunidade ou os vídeos no nosso canal. 😃 Artigos relacionados Como configurar o Stripe como integração de pagamentos no Blip Multi Product List + Cart - Vendas WhatsApp Como utilizar as Notificações Recorrentes no Messenger? (Recurrent Notifications) Como configurar o seu modelo de IA no Chatbot Como adicionar um bot em um site utilizando o Blip Chat?
