Crear Transacción Compra con 3DS
Permite ejecutar una transacción de compra con 3DS enviando al API los datos del método de pago del cliente.
Last updated
Was this helpful?
Permite ejecutar una transacción de compra con 3DS enviando al API los datos del método de pago del cliente.
Last updated
Was this helpful?
En síntesis el API funciona de la siguiente manera:
Desde el Back End del sistema se invoca el API y del objeto de retorno se toma la url del parámetro "urlCompletarPago3Ds"
Se redirecciona el explorador del usuario que desea pagar a esa URL
Luego se valida si el pago fue exitoso o fallido ya se por la o el
En este ejemplo se incluyen solamente los parámetros obligatorios
En la sección anterior se definió una petición básica para crear una transacción de compra con 3DS. En esta sección se detallan todas las propiedades opcionales que se pueden incluir.
Campo
Es Requerido
Tipo Dato
Descripción
monto
si
double
El monto que se desea cargar a la tarjeta de crédito en la transacción
si
string
El e-mail del cliente que realiza la compra. Es de utilidad ya que allí es donde Wompi enviará una notificación de su compra al cliente su se activa dicha opción.
nombre
si
string
Los nombres del cliente que realiza la compra.
apellido
si
string
Los apellidos del cliente que realiza la compra
ciudad
si
string
La ciudad indicada por el cliente
direccion
si
string
Dirección del cliente
idPais
si
string
idRegion
si
string
codigoPostal
si
string
Código postal del cliente.
telefono
si
string
Teléfono del cliente
tarjetaCreditoDebito
si
Objeto
Ver definición de objeto abajo.
configuracion
no
Objeto
Ver definición de objeto abajo. Solo se necesita si se desea utilizar una configuración diferente a la que esta definida a nivel de aplicativo.
datosAdicionales
no
Diccionario
Campo
Es Requerido
Tipo Dato
Descripción
numeroTarjeta
si
string
El numero de tarjeta sin espacios.
cvv
si
string
Una cadena de caracteres solo con números con el CVV de la tarjeta a la que se le desea hacer el cobro
mesVencimiento
si
entero
El mes en que se vence la tarjeta
anioVencimiento
si
entero
El año en que se vence la tarjeta
Campo
Es Requerido
Tipo Dato
Descripción
emailsNotificacion
no
string
Lista de correos electrónicos divididos por coma a los que se enviará una notificación si la transacción es exitosa.
urlWebhook
no
string
telefonosNotificacion
No
string
Lista de telefonos dividida por comas a los que se enviará una notificación de esta transacción
notificarTransaccionCliente
No
bool
Indica si Wompi debe enviar una notificación por correo electrónico al cliente después de efectuar una transacción exitosa. El correo del cliente ex capturado en la interfaz de pago.
Campo
Tipo Dato
Descripción
idTransaccion
string
Identificador único de la transacción
esReal
bool
Verdadero si es un transacción ejecutada en producción, falso si es una transacción en desarrollo. La transacción en desarrollo no se cobra al cliente.
urlCompletarPago3Ds
string
URL para que el usuario pagador pueda completar el pago con 3DS. El usuario que desea pagar debe redireccionarse a esta URL para que finalice el proceso de pago.
monto
decimal
El monto cobrado en la transacción
Código ISO 3166-1 alpha2 para el país del cliente. Ver
Código ISO 3166-2 para el territorio del cliente. Ver
Permiten al cliente enviar una lista de Llave/Valor para identificar características adicionales de la transacción. Esta lista de Llave/Valor se entregan al comercio vía el .
Url proporcionada por el comercio que se invocará con los datos de la transacción cuando esta sea exitosa. Los webhook son la manera principal que los sistemas del comercio se enteren de una transacción exitosa. Para más información ver la sección.
Permiten al cliente enviar una lista de Llave/Valor para identificar características adicionales de la transacción. Esta lista de Llave/Valor se entregan al comercio vía el .