Formularios

Un formulario en Bamboo Payment le permite a sus clientes realizar compras o tokenizaciones a través de una interfaz web.

Métodos soportados

GetToken

Este método recibe un objeto con los parámetros específicos del medio de pago deseado.

Objeto tokenRequest:

PropiedadDescripción¿Obligatorio?
Red físicaTarjetasFlujo Redirect
PaymentMediaId
numeric
Identificador del medio de pago.
PaymentMediaType
numeric
Identificador del tipo de medio de pago (vea la tabla tipos de medio de pago).
IssuerBank
numeric
Identificador del banco (vea la tabla Banco Emisor).
Email
string
Dirección de correo electrónico del cliente.
DocumentNumber
string
Número de documento del cliente.
DocumentType
numeric
Tipo de documento del cliente.
LoyaltyPlanId
numeric
Identificador del plan de fidelización.
LoyaltyPlanUserIdentification
string
Identificador del usuario del plan de fidelización.

Ejemplos:


Este ejemplo genera un token para RedPagos.

var tokenRequest = {
 PaymentMediaId: 5, 
 Email: "john@mail.com", 
 DocumentNumber: "12345672", 
 DocumentType: 2
 };
 
PWCheckout.Iframe.GetToken(tokenRequest);

Este ejemplo abre el formulario de captura solo para tarjetas MasterCard.

var tokenRequest = {
 PaymentMediaId: 2, 
 Email: "john@mail.com"
 };
 
PWCheckout.Iframe.GetToken(tokenRequest);

Este ejemplo abre el formulario de captura solo para tarjetas MasterCard emitidas por banco Santander.

var tokenRequest = {
 PaymentMediaId: 2, 
 IssuerBank: 1, 
 Email: "john@mail.com"
 };
 
PWCheckout.Iframe.GetToken(tokenRequest);

Este ejemplo abre el formulario de captura solo para tarjetas Visa Débito.

var tokenRequest = {
 PaymentMediaId: 1, 
 PaymentMediaType: 2, 
 Email: "john@mail.com"
 };
 
PWCheckout.Iframe.GetToken(tokenRequest);

Este ejemplo genera un OneTimeToken para pagos en Khipu.

var tokenRequest = {
 PaymentMediaId: 110, 
 Email: "john@mail.com"
 };
 
PWCheckout.Iframe.GetToken(tokenRequest);

Objetos JavaScript

CloseInfo

El objeto CloseInfo se retorna en el evento closed, que se lanza cuando el usuario cierra el formulario de captura de datos de la tarjeta.

CampoDescripción
Reason
string
Descripción de la razón del cierre de la ventana. Las causas posibles son las siguientes:
  • ESCAPE: El usuario presionó el botón Esc.
  • CLOSE_BUTTON: El usuario presionó el botón de cierre de la ventana.
  • TIMEOUT: El usuario ha excedido el tiempo máximo para ingresar la información.
  • COMMERCE_ACTION: El comercio necesita realizar una acción.
  • ERROR: Ocurrió un error.
  • TOKEN_RECEIVED: Se recibió el token de la información ingresada por el usuario.
  • NOTIFICATION_RECEIVED: Se recibió una notificación.
  • PAGE_CLICK: El usuario hizo clic fuera de la forma de captura y la propiedad close_onclick está en true.

TokenInfo

El objeto TokenInfo se retorna en el evento tokenCreated lanzado por el formulario de captura de datos de la tarjeta después de procesar la información del usuario.

Campo
Tipo
Descripción
TokenId
string
Identificador del token.
Created
timestamp
Fecha y hora de creación del token.
Type
string
Tipo de token, posibles valores:
  • OneTime
  • Commerce
Brand
string
Marca de la tarjeta o medio de pago utilizado.
IssuerBank
string
Banco Emisor de la tarjeta.
Owner
string
Nombre del tarjetahabiente.
Bin
numeric[6]
Identificador de la tarjeta.
Last4
numeric[4]
Cuatro últimos dígitos de la tarjeta.
CardType
string
Tipo de medio de pago o tarjeta, posibles valores:
  • CreditCard
  • DebitCard
  • PhysicalNetwork
  • PrePaid
CardExpMonth
numeric[2]
Mes de vencimiento de la tarjeta.
CardExpYear
numeric[2]
Año de vencimiento de la tarjeta.

NotificationInfo

El objeto NotificationInfo se retorna en el evento notificationReceived, que se lanza cuando termina el flujo de Solicitud del código de verificación.

Campo
Tipo
Descripción
ProcessType
string
Define el tipo de proceso de la notificación que se está lanzando.
Los posibles valores son:
  • PURCHASE_PENDING – proceso para autorizar compras pendientes.
ProcessStatus
numeric[1]
Los estados posibles del proceso son:
  • 1 – OK (el proceso se completó exitosamente)
  • 2 – PENDING (el proceso sigue pendiente)
  • 3 – ERROR (el proceso se completó con errores)

Temas en esta sección

Formulario del Checkout

Amplificado y con capacidad de respuesta adecuada para aplicaciones web y móviles.

Formulario del Checkout embebido

Corresponde a un formulario de Checkout incrustado en su página, simplificando y asegurando la captura de datos sensibles para el procesamiento de pagos en línea.

footer
Última modificación 24 de junio de 2024

© Bamboo | All rights reserved 2024