Akua dispone de una solución de bóveda. Esta solución permite la tokenización de datos sensibles, sustituyéndolos por un token único e irreversible. De esta manera, garantizamos que la información real nunca sea almacenada ni procesada fuera de entornos seguros. Gracias a esta tecnología, Akua ofrece una API que permite almacenar de forma segura cualquier tipo de instrumento, generando un identificador único para su uso en nuestras plataformas. Esto facilita el alta de instrumentos de manera centralizada, permitiendo utilizar el identificador generado para realizar todas las acciones subsecuentes de manera eficiente y segura.

Características principales

Creación de Tarjetas

La creación de tarjetas es el proceso mediante el cual se crea un registro de una tarjeta en nuestro sistema. Este proceso genera un identificador único e irreversible, asociado a la tarjeta, que permite acceder a la información no sensible de la misma fuera de un entorno seguro. Además, los datos completos pueden ser recuperados bajo los permisos adecuados y en condiciones de seguridad controlada, garantizando así la protección de la información sensible en todo momento. Referencia de API

{
    "type": "CARD",
    "card": {
        "number": "5186170070001108",
        "expiration_month": "03",
        "expiration_year": "26",
        "first_name": "firstName",
        "last_name": "lastName",
        "cvv": "111"
    },
    "user_data": {
        "billing_address": {
            "street": "Calle 26",
            "number": "45A-60",
            "city": "Bogotá",
            "state": "Cundinamarca",
            "zip_code": "110911",
            "country": "COL"
        }
    }
}

La user_data es un campo opcional, aunque se recomienda enviarlo siempre que sea posible. Esta información contribuye a aumentar la tasa de aprobación de las transacciones.

El campo card.cvv también es opcional, ya que este valor puede ser asignado a la tarjeta en cualquier momento según sea necesario.

Obtención de Tarjetas
Se puede utilizar el método GET del servicio de medios de pago para obtener la información de la tarjeta creada, proporcionando su identificador como parámetro en la ruta.Referencia de API

{
    "id": "ins-cunovcf79diaq0nhi7lg",
    "type": "CARD",
    "status": "ACTIVE",
    "validation": "PENDING",
    "client_id": "cli-csgg2dblhcklgmeucd10",
    "organization_id": "",
    "payment_method": "CARD_MASTERCARD_CREDIT",
    "fingerprint": "5d3cb7bc9b46a595",
    "created_at": "2025-02-14T18:47:13.143693801Z",
    "updated_at": "2025-02-14T18:47:13.143693801Z",
    "user_data": {
        "billing_address": {
            "street": "Calle 26",
            "number": "45A-60",
            "city": "Bogotá",
            "state": "Cundinamarca",
            "zip_code": "110911",
            "country": "COL"
        }
    },
    "card": {
        "token": "tkn_e57ea0c96c9e4cb4a1c958b6913cf552",
        "last_four_digits": "1108",
        "issuer_identification_number": "518617",
        "first_name": "firstName",
        "last_name": "lastName",
        "expiration_month": "03",
        "expiration_year": "26",
        "bin_data": {
            "card_brand": "MASTERCARD",
            "card_type": "CREDIT"
        }
    }
}

Luego de 10 años de la ultima actualización de una tarjeta las mismas son archivadas.

Actualización de Tarjetas

Se puede utilizar el método PATCH del servicio de medios de pago para actualizar los datos de una tarjeta creada, proporcionando su identificador como parámetro en la ruta y los datos a actualizar en el cuerpo de la solicitud. Por ejemplo, la carga del CVV se puede realizar mediante esta acción. Referencia de API

{
    "type": "CARD",
    "card": {
        "cvv": "123"
    }
}

Borrado de Tarjetas

Se puede utilizar el DELETE del servicio de medio de pagos para eliminar la información de una tarjeta creada, proporcionando su identificador como parámetro en la ruta. Referencia de API