Índice:

Esta funcionalidade está em beta. Quer ter acesso antecipado? Inscreva-se para testá-la antes do lançamento oficial!

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 Blip",

            "images": [

                "https://www.blip.net/files/themes/blank_theme/assets/img/blip-og-image.png"

            ],

            "name": "Curso do Blip - Módulo de Pagamentos",

            "quantity": 1

        },

        {

            "amount": 20000,

            "currency": "brl",

            "description": "Curso do Blip - Fornecido pela Blip",

            "images": [

                "https://www.blip.net/files/themes/blank_theme/assets/img/blip-og-image.png"

            ],

            "name": "Curso do Blip - Módulo de Catálogo",

            "quantity": 1

        }

    ],

    "paymentIntentData": {"setupFutureUsage": "on_session"},

    "successUrl": "https://www.Blip.net",

    "cancelUrl": "https://www.Blip.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. 😃

Pagamento por página web (Cartão de crédito/débito e boleto)

Pagamento automático (Card on file)

Artigos relacionados