Esta funcionalidad está en beta. ¿Quieres tener acceso anticipado? ¡Regístrese para probarlo antes del lanzamiento oficial!
Índice:
- Pagos en Builder
- Pago por página web (Tarjeta de crédito/débito y recibo bancario)
- Pago automático (Card on file)
Pagos en Builder
Para utilizar pagos en el builder, es necesario usar la acción de procesar comandos para enviar comandos de pagos. Esta acción se puede agregar a las acciones de entrada o salida del bloque según se desee.
Como se mencionó anteriormente, existen diferentes tipos de pagos. Para cada pago, debemos completar la acción de procesar comando de una forma diferente, que se presentará a continuación.
Pago por página web (Tarjeta de crédito/débito y recibo bancario)
Preliminarmente, es importante mencionar que el método de pago a través de la página web integra el pago de Stripe Session y, a modo de ejemplo, solo se presentará una parte de los datos que se pueden informar para generar este tipo de pago. Para más detalles, acceda a la documentación de Stripe.
A continuación se muestra una referencia de los datos a llenar en este comando, es un ejemplo del resource a enviar:
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 de Blip - Proporcionado por Take Blip",
"images": [
"https://www.take.net/files/themes/blank_theme/assets/img/take-og-image.png"
],
"name": "Curso do Blip - Módulo de Pagos",
"quantity": 1
},
{
"amount": 20000,
"currency": "brl",
"description": "Curso de Blip - Proporcionado por Take Blip",
"images": [
"https://www.take.net/files/themes/blank_theme/assets/img/take-og-image.png"
],
"name": "Curso de Blip - Módulo de Catálogo",
"quantity": 1
}
],
"paymentIntentData": {"setupFutureUsage": "on_session"},
"successUrl": "https://www.take.net",
"cancelUrl": "https://www.take.net"
}
Cada campo del ítem "Resource" tiene una función importante en la generación de este tipo de pago, vea a continuación lo que representa cada campo en este ejemplo de resourse. Vale la pena recordar que como se mencionó anteriormente, es posible usar más campos para personalizar su pago como desee, para más detalles, acceda a la documentación de Stripe.
|
Campos de Resource |
Descripción |
|
paymentMethodTypes |
Tipo de pago |
|
lineItems |
Ítems que serán adquiridos acompañados de sus respectivos precios, imágenes, nombre, cantidad. |
|
successUrl |
URL del sitio al que se redirigirá al usuario después de realizar el pago completo |
|
cancelUrl |
URL del sitio web al que se redirigirá al usuario si se cancela el pago |
|
paymentIntendData.setupFutureUsage |
Datos necesarios para guardar los datos de la tarjeta utilizada en el link de pago para uso futuro (Pago Card on File).
En este caso, se informará al usuario en la pantalla de checkout que, al cerrar el pago, permitirá que la marca almacene los datos de este pago para uso futuro.
Atención: la interfaz de Stripe no permite que el usuario elija guardar la tarjeta durante el checkout. Esto debe hacerse durante la generación del link, ya que el parámetro utilizado al generar el link determina si la tarjeta se guardará o no. Por lo tanto, es importante que el proceso de elección del usuario para guardar o no la tarjeta se realice en el bot, en el momento de la generación del link.
La propiedad “setupFutureUsage” permite dos valores: “on_session” y “off_session”. Para comprender mejor la diferencia entre ellos, consulte la documentación de Stripe. |
Vea un ejemplo de la acción configurada para este tipo de pago:
Al final de este proceso, si el contacto realiza el pago con éxito, su stripeCustomerId (ID de cliente de Stripe) se agregará a su información adicional. Por lo tanto, el valor de stripeCustomerId debe informarse en pagos futuros para mantener el contexto de pago único y actualizado por contacto.
A continuación se muestra un ejemplo de esta información vinculada al contacto:
Pago automático (Card on file)
Para realizar este tipo de pago, el contacto debe haber realizado previamente un pago a través de la web y haber guardado la tarjeta para futuras compras. Una forma de validar si un contacto completó este paso es verificar si el "stripeCustomerId" está presente en los extras de la información del contacto.
De igual manera, cabe mencionar que el método de pago automático (Card on file) forma parte del pago Payment Intent do Stripe y, a modo de ejemplo, solo se presentará una parte de los datos que se pueden informar para generar este tipo de pago. Para más detalles, acceda a la documentación de Stripe.
A continuación se muestra una referencia de los datos a llenar en este comando y un ejemplo del resourse a enviar:
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 del elemento "Resourse" tiene un papel importante en la generación de este tipo de pago, vea a continuación lo que representa cada campo en este ejemplo de resourse. Vale la pena recordar que como se mencionó anteriormente, es posible usar más campos para personalizar su pago como desee, para más detalles, acceda a la documentación de Stripe.
|
Campos de Resource |
Descripción |
|
customer |
Identificador de customer |
|
paymentMethodTypes |
Tipo de pago |
|
amount |
Valor a pagar |
|
currency |
Código de la moneda de tres letras. |
|
confirm |
Confirmar el pago automáticamente después de recibir el pago. |
|
paymentMethod (Opcional) |
Identificador de la tarjeta con la que se realizará el pago. Si no se informa, el pago se realizará con la tarjeta estándar. (busque y seleccione tarjetas registradas a través de este endpoint) |
Vea un ejemplo de la acción configurada para este tipo de pago:
Para más información, acceda a la discusión sobre el tema en nuestra comunidad o vea los videos en nuestro canal. 😃