> ## Documentation Index
> Fetch the complete documentation index at: https://docs.localpayment.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Tokenización

La tokenización con Localpayment proporciona una forma segura de gestionar la información de las tarjetas, reduciendo el riesgo de seguridad y simplificando las transacciones futuras.

## Cómo funciona

El proceso consta de los siguientes pasos clave:

1. **Recopilación de información de la tarjeta**: La información de la tarjeta se recopila de forma segura a través de un formulario dentro de tu aplicación y luego se transmite a la API de Localpayment.
2. **Generación de tokens**: Localpayment almacena de forma segura la información de la tarjeta y genera un token único e irreversible que representa los datos de la misma. Este token se devuelve en la respuesta de la API.
3. **Uso de la tarjeta tokenizada**: Para los pagos posteriores con tarjeta, enviarás la propiedad `card.token` en lugar de los datos reales de la tarjeta del cliente.

***

## Antes de comenzar

Antes de tokenizar una tarjeta, asegúrate de haber completado lo siguiente:

> [card] [Credenciales de API](https://docs.localpayment.com/es/docs/api-keys-and-environments.md)
>
> Credenciales API válidas y token de acceso para la autenticación.

> [card] [Configuración de la cuenta](https://docs.localpayment.com/es/docs/make-your-first-test-payment.md)
>
> Configuración adecuada de la cuenta para el país de destino y verificación de la empresa.

> [card] [Lista blanca de IP](https://docs.localpayment.com/es/docs/dashboard-whitelist-your-ips.md)
>
> Incluye en la lista blanca las direcciones IP de tus servidores para el acceso a la API.

> [card] [Endpoint del webhook](https://docs.localpayment.com/es/docs/webhooks.md)
>
> Configura una URL de webhook para recibir notificaciones de pago.

***

## Métodos de tokenización

Existen dos métodos disponibles para tokenizar una tarjeta:

* [Endpoint para la tokenización de tarjetas](#option-1-endpoint-for-card-tokenization)
* [Tokenización de la tarjeta durante el pago](#option-2-card-tokenization-during-payment)

### Opción 1: Endpoint para la tokenización de tarjetas

Puedes tokenizar de forma segura la información de la tarjeta para su uso futuro a través de un endpoint dedicado.

Para tokenizar una tarjeta, envía una solicitud `POST` al endpoint [Tokenizar tarjeta](https://docs.localpayment.com/es/reference/tokenize-card.md) con los siguientes parámetros:

| Parámetro | Descripción | Requerido |
| - | - | - |
| `name` | Nombre del titular de la tarjeta. | ✅ |
| `number` | Número de tarjeta. | ✅ |
| `cvv` | Valor de verificación de la tarjeta. | ✅ |
| `expirationMonth` | Mes de vencimiento de la tarjeta. | ✅ |
| `expirationYear` | Año de vencimiento de la tarjeta. | ✅ |

#### Ejemplo de solicitud

```bash curl theme={"theme":{"light":"github-light-high-contrast","dark":"github-dark-high-contrast"}}
curl --request POST \
     --url https://api.stage.localpayment.com/api/card \
     --header 'Authorization: Bearer <your_access_token>' \
     --header 'accept: application/json' \
     --header 'content-type: application/json' \
     --data '
{
  "name": "John Doe",
  "number": "4000000000000002",
  "cvv": "123",
  "expirationMonth": "11",
  "expirationYear": "2029"
}
'
```

#### Ejemplo de respuesta exitosa

En respuesta, la API devuelve el token de la tarjeta:

```json theme={"theme":{"light":"github-light-high-contrast","dark":"github-dark-high-contrast"}}
{
  "card": {
    "token": "xsWMaLcYjS3L11aBwxl465%2F2d8J85FXPAaBFIKfr0Fx%3D",
    "bin": "400000",
    "brand": "VISA",
    "country": "US",
    "name": "John Doe",
    "last4": "0002",
    "expirationYear": 2029,
    "expirationMonth": 11
  },
  "errors": []
}
```

#### Campos de respuesta clave

| Campo | Descripción |
| - | - |
| `card.token` | Tarjeta tokenizada. |

### Opción 2: Tokenización de la tarjeta durante el pago

Localpayment permite a los comercios tokenizar tarjetas durante el [procesamiento de pagos](https://docs.localpayment.com/es/docs/one-time-payments.md)  incluyendo el parámetro `save` en las solicitudes de pago. Este enfoque simplificado te permite procesar una transacción y almacenar los datos de la tarjeta en una sola llamada a la API.

Para tokenizar una tarjeta, envía una solicitud `POST` al endpoint [Crear Payin](https://docs.localpayment.com/es/reference/payins.md) e incluye la propiedad `card.save` establecida en `true` en tu solicitud de Payin.

#### Ejemplo de solicitud

```bash curl theme={"theme":{"light":"github-light-high-contrast","dark":"github-dark-high-contrast"}}
curl --request POST \
  --url https://api.stage.localpayment.com/api/payin/ \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer <your_access_token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "paymentMethod": {
        "type": "CreditCard",
        "code": "1600",
        "flow": "DIRECT"
    },
    "externalId": "dffbd2a6-6e65-469b-8bbe-dac269882220",
    "country": "MEX",
    "currency": "MXN",
    "amount": 1000,
    "accountNumber": "{{accountNumber}}",
    "conceptCode": "0001",
    "merchant": {
        "type": "COMPANY",
        "name": "Company",
        "document": {
            "type": "RFC",
            "id": "XXX840510XX1"
        },
        "email": "mail@company.com"
    },
    "payer": {
        "type": "INDIVIDUAL",
        "name": "John",
        "lastname": "Doe",
        "document": {
            "type": "RFC",
            "id": "YYY180222YY6"
        },
        "email": "john.doe@example.com"
    },
    "card": {
        "number": "4000000000000002",
        "cvv": "123",
        "expirationMonth": "12",
        "expirationYear": "2029",
        "save": true
    }
}'
```

#### Ejemplo de respuesta exitosa

En respuesta, la API devuelve el token de la tarjeta:

```json theme={"theme":{"light":"github-light-high-contrast","dark":"github-dark-high-contrast"}}
{
  "transactionType": "PayIn",
  "externalId": "dffbd2a6-6e65-469b-8bbe-dac269882220",
  "internalId": "22b29c98-92af-44bd-a164-1863ae2f1bb3",
  "paymentMethod": {
    "type": "CreditCard",
    "code": "1000",
    "flow": "DIRECT"
  },
  "country": "MEX",
  "currency": "MXN",
  "amount": 1000,
  "accountNumber": "{{accountNumber}}",
  "confirmed": {
    "currency": "MXN",
    "amount": 1000,
    "fxQuote": 1,
    "exchangeRateToken": null
  },
  "payment": {
    "installment": null,
    "currency": "MXN",
    "fxQuote": 1,
    "financingFee": 0,
    "amount": 1000
  },
  "localTaxes": [],
  "withHoldings": [],
  "fees": {
    "description": "Fee",
    "currency": "MXN",
    "fxSource": 210.8,
    "fxQuote": 1,
    "amount": 13.02,
    "account": "{{accountNumber}}"
  },
  "status": {
    "code": "103",
    "description": "APPROVED",
    "detail": "The payin was confirmed but not credited yet"
  },
  "ticket": null,
  "qr": null,
  "beneficiary": null,
  "merchant": {
    "type": "COMPANY",
    "name": "Company"
  },
  "payer": {
    "type": "INDIVIDUAL",
    "name": "John",
    "lastname": "Doe",
    "document": {
      "id": "YYY180222YY6",
      "type": "RFC"
    },
    "email": "john.doe@example.com",
    "address": null,
    "birthdate": null,
    "nationality": null
  },
  "intermediaries": [],
  "wireInstructions": null,
  "date": {
    "creationDate": "2024-05-19T19:02:44.018+00:00",
    "processedDate": "2024-05-19T19:02:44.799618",
    "expirationDate": "0001-01-01T00:00:00"
  },
  "card": {
    "token": "xsWMaLcYjS3L11aBwxl465%2F2d8J85FXPAaBFIKfr0Fx%3D",
    "bin": "400000",
    "brand": "VISA",
    "country": "RS",
    "name": "John Doe",
    "last4": "0002",
    "expirationYear": 2029,
    "expirationMonth": 12
  },
  "errors": []
}
```

#### Campos de respuesta clave

| Campo | Descripción |
| - | - |
| `card.token` | Tarjeta tokenizada. |

***

## Uso de tarjetas tokenizadas

Para usar una tarjeta tokenizada en un pago, incluye el `card.token` en tu solicitud de pago.

### Ejemplo de solicitud con token

```bash curl theme={"theme":{"light":"github-light-high-contrast","dark":"github-dark-high-contrast"}}
curl --request POST \
  --url https://api.stage.localpayment.com/api/payin/ \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer <your_access_token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "paymentMethod": {
        "type": "CreditCard",
        "code": "1600",
        "flow": "DIRECT"
    },
    "externalId": "dffbd2a6-6e65-469b-8bbe-dac269882220",
    "country": "MEX",
    "currency": "MXN",
    "amount": 1000,
    "accountNumber": "{{accountNumber}}",
    "conceptCode": "0001",
    "merchant": {
        "type": "COMPANY",
        "name": "Company",
        "document": {
            "type": "RFC",
            "id": "XXX840510XX1"
        },
        "email": "mail@company.com"
    },
    "payer": {
        "type": "INDIVIDUAL",
        "name": "John",
        "lastname": "Doe",
        "document": {
            "type": "RFC",
            "id": "YYY180222YY6"
        },
        "email": "john.doe@example.com"
    },
    "card": {
        "token": "WleV6CZ111IMxqp53SIrqzOn1JsGKCef8oBh2mbi56M%3D",
        "cvv": "123",
        "installments": "1"
    }
}'
```

***

## Obtener información de la tarjeta

Una vez tokenizada una tarjeta, puedes recuperar sus detalles mediante la API de Localpayment. Esto te permite mostrar a los clientes los métodos de pago almacenados, manteniendo la conformidad con la normativa PCI.

Para obtener la información de una tarjeta, envía una solicitud `GET` al endpoint [Obtener detalles de la tarjeta](https://docs.localpayment.com/es/reference/get-card.md), incluyendo el token de la tarjeta como parámetro de consulta.

### Ejemplo de solicitud

```bash curl theme={"theme":{"light":"github-light-high-contrast","dark":"github-dark-high-contrast"}}
curl --location 
--request GET 'https://api.stage.localpayment.com/api/card/?token={token}' \
--header 'Authorization: Bearer <your_access_token>'
```

### Ejemplo de respuesta exitosa

En respuesta, la API devuelve los detalles de la tarjeta:

```json theme={"theme":{"light":"github-light-high-contrast","dark":"github-dark-high-contrast"}}
 {
  "card": {
    "token": "WleV6CZ111IMxqp53SIrqzOn1JsGKCef8oBh2mbi56M%3D",
    "bin": "400000",
    "brand": "VISA",
    "country": "US",
    "name": "",
    "last4": "0002",
    "expirationYear": 2029,
    "expirationMonth": 11
  },
  "errors": []
}
```

***

## Eliminar una tarjeta tokenizada

Elimina permanentemente los tokens de tarjeta almacenados mediante un endpoint de API dedicado. Esta acción irreversible ayuda a mantener el cumplimiento de las normativas de privacidad de datos y permite una gestión adecuada del ciclo de vida de la tarjeta.

Para eliminar una tarjeta tokenizada, envía una solicitud `DELETE` al endpoint [Eliminar tarjeta tokenizada](https://docs.localpayment.com/es/reference/delete-card.md), incluyendo el token de la tarjeta como parámetro de consulta.

### Ejemplo de solicitud

```bash curl theme={"theme":{"light":"github-light-high-contrast","dark":"github-dark-high-contrast"}}
curl --location \
--request DELETE 'https://api.stage.localpayment.com/api/card/?token={token}' \
--header 'Authorization: Bearer <your_access_token>'
```

### Ejemplo de respuesta exitosa

Una eliminación exitosa normalmente devolverá un objeto JSON vacío:

```json theme={"theme":{"light":"github-light-high-contrast","dark":"github-dark-high-contrast"}}
{
  "errors": []
}
```

***

## Próximos pasos

Ahora que has tokenizado correctamente una tarjeta, puedes utilizar el token generado para un procesamiento seguro en todos los servicios de pago de Localpayment:

> [card] [Pagos únicos](https://docs.localpayment.com/es/docs/one-time-payments.md)
>
> Utiliza el token para procesar pagos únicos e inmediatos.

> [card] [Suscripciones](https://docs.localpayment.com/es/docs/subscriptions-overview.md)
>
> Configura ciclos de facturación recurrentes automatizados utilizando la tarjeta tokenizada.

> [card] [Cuotas](https://docs.localpayment.com/es/docs/installments.md)
>
> Ofrece a tus clientes opciones de pago a plazos mediante la tarjeta tokenizada.

> [card] [3D Secure](https://docs.localpayment.com/es/docs/3d-secure.md)
>
> Mejora la seguridad de los pagos con tarjeta tokenizada mediante la autenticación 3D Secure.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.