> For the complete documentation index, see [llms.txt](https://docs.payvalida.com/api-tarjeta/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.payvalida.com/api-tarjeta/master.md).

# Introduction

{% hint style="success" %}

### Version 1.0.0

{% endhint %}

The Tokenization API allows you to process credit card payments of a previously registered purchase order. The transaction can be with token, or with the possibility of tokenize. The API also allows you to delete tokens.

As a requirement to consume this web service, you must have a purchase order created. For this you can make use of the [API de recaudo](https://payvalida.gitbook.io/api-cashin/).

## [Transaction](/api-tarjeta/transaction.md)

It is the service by which credit card payments are processed.

The service can be consumed in two different ways:

1. **Make a transaction with the credit card details**. This process must be performed always the first time of each different credit card. When requesting the transaction you can choose whether to tokenize the credit card or not. If you choose to tokenize it, then the service will respond with a token that you should save and use it next time instead of the credit card details.
2. **Make a transaction with token**. In this way, you had to previously make a transaction with the credit card details requesting to tokenize it and save the token that the API respond to. In this way, you will not need to send the card number, expiration date, or cardholder name to the API. The CVV can be omitted for MasterCard credit cards and must be send for the other franchises.

A token will be automatically deleted after completing one year without being used, or five years from its creation in our system, whichever occurs first. If a token was deleted, the API respond with an error message and the transaction should be performed again with the credit card details, as it was performed previously in the first time, requesting to tokenize again.

## [Delete token](/api-tarjeta/delete-token.md)

It is the web service by which the stored tokens in our system will be deleted and not valid for future transactions. You can freely used it to delete previously created credit card tokens.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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, and the optional `goal` query parameter:

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

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.