# Introducción

{% hint style="success" %}

### Versión 1.0.0

{% endhint %}

El API de Tarjeta de Crédito/Débito permite procesar transacciones con tarjetas de crédito y tarjetas de débito con CVV de una orden previamente registrada.

Como prerrequisito para consumir este servicio, se debe tener una orden creada. Para ello puedes hacer uso de la [API de recaudo](https://payvalida.gitbook.io/api-cashin/).

## [Transacción](/api-tarjeta/master/transaccion/transaccion-1.md)

Es el servicio por el cual se procesan las transacciones de tarjeta de crédito/débito.

Este servicio se puede consumir de dos maneras:

1. **Hacer una transacción con los datos de la tarjeta de crédito/débito**. Se necesitan los datos de la tarjeta y del tarjetahabiente. Al enviar una transacción se puede elegir tokenizar la tarjeta. Si elige tokenizarla, el servicio responderá un token que podrá guardar y usar la próxima vez en lugar los datos de la tarjeta y del tarjetahabiente.
2. **Hacer una transacción con token**. Para esto previamente debió hacer una transacción con los datos de la tarjeta y del tarjetahabiente, enviar el parámetro *tokenizar* en *true*, y guardar el token que el servicio le respondió. Si elige hacer una transacción con token, no necesitará enviar el CVV.

### [Eliminar token](/api-tarjeta/master/transaccion/eliminar-token.md)

{% hint style="info" %}
Un token se borrará automáticamente al completar un año sin ser usado, o cinco años desde su creación, lo primero que ocurra. Si un token fue borrado recibirá un mensaje de error y deberá volver hacer una transacción con los datos de la tarjeta de crédito/débito.
{% endhint %}

Es el servicio por el cual se eliminan los tokens almacenados para procesar transacciones de tarjeta de crédito/débito.

## [Pre-Autorización](/api-tarjeta/master/pre-autorizacion/introduccion.md)

La pre-autorización te permite reservar un importe en la tarjeta del usuario y posteriormente confirmar el importe real de la transacción, el cual puede ser igual, mayor, o menor que el monto pre-autorizado. En caso que el tarjetahabiente no tenga fondos suficientes para pre-autorizar el pago, la transacción será rechazada.

## [Anulaciones](/api-tarjeta/master/anulaciones/anulaciones.md)

Este servicio permite anular pagos realizados a través de tarjeta de crédito/débito; al anular un pago el valor del pago es devuelto al usuario en su tarjeta. Las anulaciones pueden ser totales (el monto total del pago) o parciales (un monto menor al monto toal del pago). Se permiten anular transacciones y pre-autorizaciones.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.payvalida.com/api-tarjeta/master/master.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.