Wallet - Tokenización de Tarjetas y Cuentas Bancarias
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)
Administración de Clientes
A partir de esta API se crean los clientes a los cuales luego se le asocian las diferentes tarjetas
POST
Params
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
Params
Path Parameters
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
Params
Path Parameters
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
Params
Path Parameters
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.
Administración de Medios de Pago
Una vez generado el cliente, podemos cargar sus medios de pago a través de 2 alternativas:
UI de medios de pago
Ingresar los datos vía API
UI de medios de pago
Es la forma simple de cargar medios de pago a la billetera del cliente, sin requisitos de certificación extra.
Se debe redirigir al cliente a la url:
https://mobbex.com/p/wallet/{customerUID}/source
donde {customerUID} hace referencia al UID del cliente obtenido al crearlo.
Ingresar los datos vía API
Información Importante
Para poder utilizar cualquiera de los métodos abajo descriptos e ingresar los datos de los medios de pago a través de API, el comercio debe cumplimentar con certificación PCI DSS y la autorización de uso estará sujeta a auditoría por parte de Mobbex.
A través de esta API se podrá crear el token del medio de pago necesario para agregarlo a la billetera.
POST
Params
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
source.card
required
Object
Objeto con los datos de la tarjeta.
source.card.number
required
String
PAN o Número de la tarjeta.
source.card.month
required
Number
Mes de expiración de la tarjeta con formato XX
source.card.year
required
Number
Año de expiración de la tarjeta con formato YY
source.card.identification
required
String
Número de documento del tarjetahabiente .
source.card.name
required
String
Nombre del tarjetahabiente.
source.card.cvv
required
String
Código de Seguridad de la tarjeta a tokenizar. Valor opcional. Sólo requerido en el caso de activar la opción de validar la tarjeta.
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
Params
Path Parameters
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
Params
Path Parameters
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
Params
Path Parameters
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
Procesamiento de Operaciones
A partir de un cliente y un medio de pago, podemos generar una operación utilizando la siguiente API:
POST
Params
Path Parameters
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.