canonical: https://jentic.com/apis/swaggerhub.pgaldamez/api-visanet-validation

# Pgaldamez API Visanet Validation

API encargada de la validacion de tarjetas. The API exposes 2 endpoints secured with apiKey authentication.

## For AI agents

Programmatically confirmation, validation. Covers 2 operations with apiKey authentication.

## Scope

Does not handle payments, communications, or crm - use for developer tools only.

## Capabilities

- Confirmation
- Validation
- Integrate API Visanet Validation into automated workflows
- Query and filter API Visanet Validation records by parameters
- Monitor API Visanet Validation operational status and events

## Use cases

### Developer Tools Operations

Use the API Visanet Validation to perform developer tools operations programmatically. The API provides 2 endpoints covering core functionality including confirmation, validation.

Example prompt: Call POST /confirm/{product}/{merchantId} to confirmation

### Data Retrieval and Monitoring

Query API Visanet Validation resources on a schedule to track changes, generate alerts, or feed downstream dashboards. Agents poll relevant endpoints, compare against previous state, and trigger actions when thresholds are crossed.

Example prompt: Poll the primary API Visanet Validation endpoint, compare response to last known state, and alert if changed

### AI Agent Integration via Jentic

AI agents discover and call API Visanet Validation endpoints through Jentic without managing credentials directly. An agent searches for the required operation by intent, receives the matching endpoint schema, and executes the call with Jentic-managed authentication. This eliminates the need to read API documentation or handle apiKey tokens manually.

Example prompt: Search Jentic for 'confirmation', load the operation schema, and execute with Jentic-managed credentials

## Key endpoints

| Method | Path | Description |
| --- | --- | --- |
| POST | /confirm/{product}/{merchantId} | Confirmation |
| POST | /validate/{product}/{merchantId} | Validation |

## Key resources

- **Validation Api** — RESTful API to validate transactions.

## Why Jentic

- **Setup:** Wiring API Visanet Validation by hand means passing the access token in the Authorization header, threading product and merchant ids through each path, and handling the validate and confirm POST responses yourself. Through Jentic you install once, import API Visanet Validation from the API Directory, store the access token once, and your agent calls it.
- **Permission scoping:** API Visanet Validation puts the product and merchant id in the URL path (/validate/{product}/{merchantId}), so a rule can pin your agent to one merchant and nothing else. You choose the operations it may call, so the confirm step is not included unless you add it.
- **Credential handling:** Your API Visanet Validation access token is stored once, encrypted, by your own Jentic One instance and injected at execution time. It never enters the agent's prompt, logs, or context.
- **Discovery method:** Agents search Jentic by intent such as 'validate a transaction' or 'confirm a validation', and Jentic returns the matching API Visanet Validation operation with its input schema so the agent calls the right endpoint without browsing the reference docs.

## Related APIs

- **Github** — Alternative developer tools API
- **Gitlab** — Alternative developer tools API

## FAQ

### What authentication does the API Visanet Validation use?

The API Visanet Validation uses an API key passed in the `Authorization` header. Through Jentic, these credentials are stored encrypted in your Jentic One instance and injected at execution time, so raw secrets never enter the agent context.

### Can I confirmation with the API Visanet Validation?

Yes. Use the POST /confirm/{product}/{merchantId} endpoint. The API returns structured JSON responses that agents can parse and act on directly.

### What are the rate limits for the API Visanet Validation?

Rate limits are not specified in the OpenAPI spec. Check the vendor documentation for current limits. Through Jentic, rate limiting is handled automatically with retry logic built into the execution layer.

### How do I confirmation through Jentic?

Install the Jentic SDK with pip install jentic, authenticate through Jentic One, the self-hosted execution layer, then search for 'confirmation'. Jentic returns the matching API Visanet Validation operation with its input schema. Load the schema and execute the call - credentials are injected automatically.

### How many endpoints does the API Visanet Validation have?

The API Visanet Validation exposes 2 endpoints covering validation API operations.

### Can I limit what my agent is allowed to do with the API Visanet Validation?

Yes. Because you run Jentic One yourself, your own rules decide which operations and credentials the agent may use with the API Visanet Validation. Since the product and merchant id live in the URL path (/validate/{product}/{merchantId} and /confirm/{product}/{merchantId}), you can pin the agent to a single merchant and no other. You also choose which endpoints it may call, so you can grant only /validate while leaving out the /confirm step unless you explicitly add it.