Tokenización de Tarjetas y Cuentas Bancarias - Wallet Transparent
8 min
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
Creación de Cliente
A partir de esta API se crean los clientes a los cuales luego se le asocian las diferentes tarjetas
POST
https://api.mobbex.com/p/wallet
curl --location --request POST 'https://api.mobbex.com/p/wallet' \
--header 'x-api-key: zJ8LFTBX6Ba8D611e9io13fDZAwj0QmKO1Hn1yIj' \
--header 'x-access-token: d31f0721-2f85-44e7-bcc6-15e19d1a53cc' \
--header 'Content-Type: application/json' \
--data-raw '{
"reference": "my_unique_reference",
"customer": {
"email": "[email protected]",
"name": "Cliente Demo",
"identification": "12123123"
},
"test": "true"
}'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.
Consultar Cliente
Permite consultar los datos de un cliente por
GET
https://api.mobbex.com/p/wallet/{customerUID}
curl --location --request GET 'https://api.mobbex.com/p/wallet/SEAW3SDTIF5E3OFHT' \
--header 'x-api-key: zJ8LFTBX6Ba8D611e9io13fDZAwj0QmKO1Hn1yIj' \
--header 'x-access-token: d31f0721-2f85-44e7-bcc6-15e19d1a53cc'Editar Cliente
POST
https://api.mobbex.com/p/wallet/{customerUID}/action/edit
curl --location --request POST 'https://api.mobbex.com/p/wallet/SEAW3SDTIF5E3OFHT/action/edit' \
--header 'x-api-key: zJ8LFTBX6Ba8D611e9io13fDZAwj0QmKO1Hn1yIj' \
--header 'x-access-token: d31f0721-2f85-44e7-bcc6-15e19d1a53cc' \
--header 'Content-Type: application/json' \
--data-raw '{
"reference": "my_new_unique_reference",
"customer": {
"email": "[email protected]",
"name": "Cliente Demo",
"identification": "12123123"
},
"test": "false"
}'Eliminar un cliente
DELETE
https://api.mobbex.com/p/wallet/{customerUID}/action/delete
curl --location --request DELETE 'https://api.mobbex.com/p/wallet/SEAW3SDTIF5E3OFHT/action/delete' \
--header 'x-api-key: zJ8LFTBX6Ba8D611e9io13fDZAwj0QmKO1Hn1yIj' \
--header 'x-access-token: d31f0721-2f85-44e7-bcc6-15e19d1a53cc'Administración de Medios de Pago
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.
Ingresar los datos vía API
Generar token de medio de pago
A través de esta API se podrá crear el token del medio de pago necesario para agregarlo a la billetera.
POST
https://api.mobbex.com/p/sources/token
curl --location --request POST 'https://api.mobbex.com/p/sources/token' \
--header 'api-key: 6Icjn_XjdKf51ZS71234K506bPRha_nSVvwS' \
--header 'Content-Type: application/json' \
--data-raw '{
"source": {
"card": {
"number": "4507990000000010",
"month": "12",
"year": "34",
"identification": "12123123",
"name": "Cliente Demo"
}
}
}'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.
Agregar medio de pago al cliente
POST
https://api.mobbex.com/p/wallet/{customerUID}/source
curl --location --request POST 'https://api.mobbex.com/p/wallet/SEAW3SDTIF5E3OFHT/source' \
--header 'x-api-key: zJ8LFTBX6Ba8D611e9io13fDZAwj0QmKO1Hn1yIj' \
--header 'x-access-token: d31f0721-2f85-44e7-bcc6-15e19d1a53cc' \
--header 'Content-Type: application/json' \
--data-raw '{
"token": "T:Y_50ND1cD",
"priority": "primary"
}'
Editar un medio de pago
POST
https://api.mobbex.com/p/wallet/{customerUID}/source/{sourceUID}/action/edit
curl --location --request POST 'https://api.mobbex.com/p/wallet/SEAW3SDTIF5E3OFHT/source/YBATG1W8SO3SGHMZT/action/edit' \
--header 'x-api-key: zJ8LFTBX6Ba8D611e9io13fDZAwj0QmKO1Hn1yIj' \
--header 'x-access-token: d31f0721-2f85-44e7-bcc6-15e19d1a53cc' \
--header 'Content-Type: application/json' \
--data-raw '{
"priority": "secondary"
}'Eliminar medio de pago del cliente
DELETE
https://api.mobbex.com/p/wallet/{customerUID}/source/{sourceUID}/action/delete
curl --location --request DELETE 'https://api.mobbex.com/p/wallet/SEAW3SDTIF5E3OFHT/source/YBATG1W8SO3SGHMZT/action/delete' \
--header 'x-api-key: zJ8LFTBX6Ba8D611e9io13fDZAwj0QmKO1Hn1yIj' \
--header 'x-access-token: d31f0721-2f85-44e7-bcc6-15e19d1a53cc'Procesamiento de Operaciones
A partir de un cliente y un medio de pago, podemos generar una operación utilizando la siguiente API:
Generar Operación
POST
https://api.mobbex.com/p/wallet/{customerUID}/payment
curl --location --request POST 'https://api.mobbex.com/p/wallet/SEAW3SDTIF5E3OFHT/operation' \
--header 'x-api-key: zJ8LFTBX6Ba8D611e9io13fDZAwj0QmKO1Hn1yIj' \
--header 'x-access-token: d31f0721-2f85-44e7-bcc6-15e19d1a53cc' \
--header 'Content-Type: application/json' \
--data-raw '{
"source": "YBATG1W8SO3SGHMZT",
"total": 100.50,
"reference": "202105271429",
"webhook": "https://mobbex.com/process/webhook",
"securityCode": "200",
"test": true
}'