MÓDULOS
Tokenización de Tarjetas y Cuentas Bancarias - Wallet Transparent
8min
Este módulo permite la implementación de la funcionalidad de Billetera Virtual o Wallet a través de API, permitiendo la tokenización de tarjetas y su posterior utilización para realizar cobros sin necesidad de que el cliente tenga que reingresar todos los datos de la tarjeta (a excepción del CVV o código de seguridad que siempre es requerido)
A partir de esta API se crean los clientes a los cuales luego se le asocian las diferentes tarjetas
POST
Request
Header Parameters
x-api-key
required
String
Clave API de su aplicación.
x-access-token
required
String
Token de acceso del comercio
Body Parameters
reference
required
String
Referencia interna única que permite identificar a su cliente dentro de su aplicación y dentro de Mobbex.
customer
required
Object
Objeto con los datos del cliente.
customer.email
required
String
Email del cliente.
customer.name
required
String
Nombre del cliente.
customer.identification
required
String
DNI o Identificación del cliente.
test
optional
Boolean
Permite colocar al cliente en modo de pruebas y realizar operaciones con tarjetas de prueba.
features
optional
Array
Array de strings que permite configurar características específicas para el cliente.
Ejemplos del nodo features:
- validate_id: Validate ID controlará el DNI del cliente contra el Tarjeta-Habiente, rechazando la operación en caso de no coincidir.
- accept_no_funds: Accept No Funds aceptará los casos donde la tarjeta no posea fondos como un caso válido de tokenización.
Permite consultar los datos de un cliente por
GET
Request
Path Params
customerUID
required
String
UID del cliente obtenido al crearlo
Header Parameters
x-api-key
required
String
Clave API de su Aplicación
x-access-token
required
String
Token de acceso del comercio
POST
Request
Path Params
customerUID
required
String
UID del cliente obtenido al crearlo.
Header Parameters
x-api-key
required
String
Clave API de su aplicación.
x-access-token
required
String
Token de acceso del comercio.
Body Parameters
reference
optional
String
Nueva referencia del cliente.
customer
optional
Object
Objeto con los nuevos datos del cliente.
customer.email
required
String
Nuevo email del cliente.
customer.identification
required
String
Nueva identificación del cliente.
customer.name
required
String
Nuevo nombre del cliente.
test
optional
Boolean
Permite cambiar el modo del cliente
DELETE
Request
Path Params
customerUID
required
String
UID del cliente generado al crearlo.
Header Parameters
x-api-key
required
String
Clave API de su aplicación.
x-access-token
required
String
Token de acceso del comercio.
Información Importante
Para utilizar cualquiera de los métodos descriptos a continuación e ingresar los datos de los medios de pago a través de API, por favor contacta a [email protected] e indica los accesos que necesitas. Además, el sitio debe cumplir con una serie de requisitos, incluyendo las normas PCI DSS.
A través de esta API se podrá crear el token del medio de pago necesario para agregarlo a la billetera.
POST
Request
Header Parameters
api-key
required
String
Clave Pública de la entidad
Body Parameters
source
required
Object
Objeto con los datos del medio de pago a tokenizar
test
optional
Boolean
Habilita el modo de pruebas. Esto permite tokenizar tarjetas de prueba para realizar operaciones en este modo.
validate
optional
Boolean
Activando esta opción, se realiza una operación de validación de la tarjeta como mecanismo para aceptar la misma como válida.
Medio de pago válido
Un medio de pago es válido al crear su token únicamente si la propiedad "isValid" retornada en la respuesta es verdadera. En caso contrario, el medio de pago no es válido.
POST
Request
Path Params
customerUID
required
String
UID del customer obtenido al crearlo
Header Parameters
x-api-key
required
String
Clave API de su aplicación.
x-access-token
required
String
Token de acceso del comercio.
Body Parameters
token
required
String
ID del token generado.
priority
optional
String
Nivel de prioridad del token en la cuenta del cliente. Valores admitidos: "primary", "secondary", "none". Por defecto el primer medio es agregado con la prioridad "primary", el segundo con "secondary" y el resto con "none".
POST
Request
Path Params
customerUID
required
String
UID del customer obtenido al crearlo
sourceUID
required
String
UID del source a editar
Header Parameters
x-api-key
required
String
Clave API de su aplicación.
x-access-token
required
String
Token de acceso al comercio
Body Parameters
priority
optional
String
Nivel de prioridad del token en la cuenta del cliente. Valores admitidos: "primary", "secondary", "none".
DELETE
Request
Path Params
customerUID
required
String
UID del cliente
sourceUID
required
String
UID del medio de pago a eliminar
Header Parameters
x-api-key
required
String
Clave API de su aplicación.
x-access-token
required
String
Token de acceso de la entidad
A partir de un cliente y un medio de pago, podemos generar una operación utilizando la siguiente API:
POST
Request
Path Params
customerUID
required
String
UID del cliente de la billetera
Header Parameters
x-api-key
required
String
Clave API de su aplicación.
x-access-token
required
String
Token de Acceso a la entidad
Body Parameters
source
required
String
UID del medio de pago a utilizar del cliente. Si no es enviado, se utilizará el medio de pago primario si existe.
reference
required
String
Referencia de la operación. Este valor debe ser único y no podrán existir 2 operaciones en estado Aprobado con el mismo reference.
test
optional
Boolean
Permite realizar operaciones en modo de pruebas, utilizando las tarjeta de prueba.
total
required
Number
Total de la operación. Formato XXX.xx donde el PUNTO es el separador de decimales.
intent
optional
String
Tipo de operatoria de la operación. Ver documentación sobre operatoria en 2 pasos.
split
optional
Array
Array de objetos sobre los cuales se va a realizar el split si esta funcionalidad es requerida. Para más información ver documentación "Marketplace y Split de pagos".
description
optional
String
Descripción de la operación a realizar.
currency
optional
String
Moneda de la operación. Valores admitidos: "ARS". Valor por defecto: "ARS".
installment
optional
String
Referencia del plan de cuotas con el cual se va a procesar la operación. Valor por defecto "1".
webhook
optional
String
URL a la cual será informado el pago mediante WebHooks (POST)
securityCode
optional
String
Código de seguridad de la tarjeta, sólo si la misma lo requiere.
Updated 12 Sep 2024
Did this page help you?