Servicio de Tokenización

El Servicio de pagos tokenizados es una funcionalidad diseñada para mejorar la seguridad y la experiencia de las transacciones a través de Floid. Este servicio reemplaza los datos sensibles del titular de la cuenta con un token único, que puede utilizarse para realizar pagos a partir de la segunda vez sin exponer la información original. En esta sección, se describirá qué es la tokenización, cómo funciona, y los beneficios que ofrece para su aplicación.


¿Cómo Funciona la Tokenización?

  1. Generación del Token: Cuando se recibe información sensible (como un número de tarjeta de crédito), el servicio de tokenización genera un token único que reemplaza esta información.
  2. Almacenamiento Seguro: Los datos originales se almacenan de forma segura en un sistema protegido y solo se pueden acceder a ellos mediante la tokenización inversa.
  3. Uso del Token: En las transacciones, se utiliza el token en lugar de los datos originales. El sistema receptor puede validar y procesar la transacción utilizando el token.

Experiencia de flujo tokenizado o ¿qué verá tu cliente?


¿Cómo utilizar este servicio?

Para la tokenización de las credenciales del servicio de pagos, existen dos métodos principales que puedes utilizar para garantizar la seguridad y eficiencia de tus transacciones:

  1. Tokenización de credenciales al crear un pago

Utilizando el servicio de Create Payment de Floid se puede agregar una variable que encriptará las credenciales para que en futuros pagos el usuario solo autorice la transacción con su segundo o tercer método habilitado desde su banco.

Create Payment

Postman Collection 🟠

URL: https://api.floid.app/cl/payments/create

Body Request

{
    "amount" : 300,
    "store_credentials": true
}
ParámetroDescripciónTipo
store_credentialsVariable opcional para permitir el guardado o no de la credenciales.boolean

Response


  1. Tokenización de credenciales sin crear un pago

Este servicio permite tokenizar las credenciales antes de que se realice cualquier transacción. Esto es especialmente útil para almacenar credenciales de forma segura, permitiendo a los usuarios autenticarse o autorizar pagos futuros sin comprometer la seguridad de su información sensible.

Store Credentials

Postman Collection 🟠

URL Chile: {{HOST}}/cl/payments/store_credentials

Body Request

{
    "id": "111111111",
    "password": "",
    "account_number": "",
    "bank": ""
}
ParámetroDescripciónTipo
idRUT/ID del usuario sin puntos ni guiones.string
passwordContraseñastring
account_numberNúmero de cuentastring
bankBanco de origen de la cuentastring

Lista de Bancos

BancoParámetro
Banco de Chilechile_personas
Banco Estadoestado_personas
Banco Crédito Inversionesbci_personas
Banco Itaúitau_personas
Banco Santandersantander_personas
Banco Falabellafalabella_personas
Banco Scotiabankscotia_personas
Banco Ripleyripley_personas
Banco Bicebice_personas

Respuesta Exitosa:

{
    "code": 200,
    "caseid": "44f6403a-7149-43b6-8262-07180ad61760",
    "msg": "OK",
    "data": {
        "token_password": "a98706db-589f-45f8-b1eb-1a9a81821bb6"
    }
}

Errores

{
    "code": 400,
    "error_type": "INVALID_TOKEN",
    "error_code": "INVALID_TOKEN",
    "error_message": "Invalid token",
    "display_message": "Token inválido",
    "caseid": "baf4c5f5-f4f4-418b-91ac-062641552d24"
}