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.
En este ejemplo se incluyen solamente los parámetros obligatorios
{
"tarjetaCreditoDebido": {
"numeroTarjeta": "string",
"cvv": "string",
"mesVencimiento": 0,
"anioVencimiento": 0
},
"monto": 0,
"urlRedirect": "string",
"nombre": "string",
"apellido": "string",
"email": "[email protected]",
"ciudad": "string",
"direccion": "string",
"idPais": "string",
"idRegion": "string",
"codigoPostal": "string",
"telefono": "string",
}
{
"idTransaccion": "string",
"esReal": true,
"urlCompletarPago3Ds": "string",
"monto": 0
}
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.
{
"tarjetaCreditoDebido": {
"numeroTarjeta": "string",
"cvv": "string",
"mesVencimiento": 0,
"anioVencimiento": 0
},
"monto": 0,
"configuracion": {
"emailsNotificacion": "string",
"urlWebhook": "string",
"telefonosNotificacion": "string",
"notificarTransaccionCliente": true
},
"urlRedirect": "string",
"nombre": "string",
"apellido": "string",
"email": "[email protected]",
"ciudad": "string",
"direccion": "string",
"idPais": "string",
"idRegion": "string",
"codigoPostal": "string",
"telefono": "string",
"datosAdicionales": {
"additionalProp1": "string",
"additionalProp2": "string",
"additionalProp3": "string"
}
}
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 |
email | 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 | 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 webhook. |
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 | 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 Webhook. |
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. |
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 webhook.
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 cliente pueda completar el pago con 3DS |
monto | decimal | El monto cobrado en la transacción |