For Agents
Programmatically authentication endpoint, logout. Covers 109 operations with basic, oauth2 authentication.
Install Jentic One Beta
Jentic One is a self-hosted execution layer for AI agents. It lets your agent call the Velo Payments APIs, or any other public or private API you need. You set the rules, the agent never sees your credentials, and every call is logged.
Two steps, two machines. Install the instance in a safe environment, then register your agent from wherever it runs.
Step 1: Jentic One Host machine
# On the machine that will host your Jentic One instance:
curl -fsSL "https://jentic.com/install.sh?src=apis&api=%2Fapis%2Fvelopayments.com%2Fvelopayments" | shStep 2: Agent machine
# On the machine where your agent runs (keep this separate from the instance):
curl -fsSL "https://jentic.com/install.sh?src=apis&api=%2Fapis%2Fvelopayments.com%2Fvelopayments" | sh
jentic register # connects your agent to your Jentic One instanceJentic One is in public beta. The setup above keeps your agent separate from the instance, which is what you want before using real credentials: an agent running as the same OS user as Jentic One can read its stored keys directly. Just evaluating? A single local install is fine to start. See the secure deployment guide for the tiers.
What an agent can do with Velo Payments APIs.
Authentication endpoint
Logout
Reset password
validate
GET STARTED
Use for: I need to authentication endpoint, I want to logout, Search for reset password, Find all validate
Not supported: Does not handle communications, crm, or developer tools - use for payments only.
Terms and Definitions Throughout this document and the Velo platform the following terms are used: * **Payor.** An entity (typically a corporation) which wishes to pay funds to one or more payees via a payout. * **Payee.** The recipient of funds paid out by a payor. * **Payment.** A single transfer of funds from a payor to a payee. * **Payout.** A batch of Payments, typically used by a payor to lo. The API exposes 109 endpoints secured with basic, oauth2 authentication.
List Users
Get User
Delete a User
Patterns agents use Velo Payments APIs for, with concrete tasks.
★ Payments Operations
Use the Velo Payments APIs to perform payments operations programmatically. The API provides 109 endpoints covering core functionality including authentication endpoint, logout, reset password.
Call POST /v1/authenticate to authentication endpoint
Automated Payees Management
Automate payees operations by combining multiple Velo Payments APIs endpoints. Agents can logout and then reset password in a single workflow.
Call POST /v1/logout to logout, then verify the result
AI Agent Integration via Jentic
AI agents discover and call Velo Payments APIs 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 basic, oauth2 tokens manually.
Search Jentic for 'authentication endpoint', load the operation schema, and execute with Jentic-managed credentials
109 endpoints — terms and definitions throughout this document and the velo platform the following terms are used: * **payor.
METHOD
PATH
DESCRIPTION
/v1/authenticate
Authentication endpoint
/v1/logout
Logout
/v1/password/reset
Reset password
/v1/validate
validate
/v2/users
List Users
/v2/users/{userId}
Get User
/v2/users/{userId}
Delete a User
/v2/users/{userId}/disable
Disable a User
/v1/authenticate
Authentication endpoint
/v1/logout
Logout
/v1/password/reset
Reset password
/v1/validate
validate
/v2/users
List Users
/v2/users/{userId}
Get User
What agents get from Jentic-routed access to this vendor.
Setup
Wiring the Velo Payments APIs by hand means handling both basic auth and the OAuth2 client-credentials flow, choosing between the sandbox and production velopayments.com hosts, and coding each authentication and user operation yourself. Through Jentic you install once, import the Velo Payments APIs from the API Directory, store the credentials once, and your agent calls it.
Permission scoping
Velo puts the user id in the URL path (/v2/users/{userId}), so a rule can pin your agent to one user. You choose the operations it may call, so destructive ones like deleting or disabling a user are not included unless you add them.
Credential isolation
Your Velo Payments credentials are stored once, encrypted, by your own Jentic One instance and injected at execution time. They never enter the agent's prompt, logs, or context.
Intent-based discovery
Agents search Jentic by intent such as 'authenticate a session' or 'list users', and Jentic returns the matching Velo Payments operation with its input schema so the agent calls the right endpoint without browsing the reference docs.
Alternatives and complements available in the Jentic catalogue.
Stripe
Alternative payments API
Choose Stripe when you need a different approach to payments operations
Specific to using Velo Payments APIs through Jentic.
What authentication does the Velo Payments APIs use?
The Velo Payments APIs uses basic, oauth2 authentication. 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 authentication endpoint with the Velo Payments APIs?
Yes. Use the POST /v1/authenticate endpoint. The API returns structured JSON responses that agents can parse and act on directly.
What are the rate limits for the Velo Payments APIs?
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 authentication endpoint through Jentic?
Install the Jentic SDK with pip install jentic, authenticate through Jentic One, the self-hosted execution layer, then search for 'authentication endpoint'. Jentic returns the matching Velo Payments APIs operation with its input schema. Load the schema and execute the call - credentials are injected automatically.
How many endpoints does the Velo Payments APIs have?
The Velo Payments APIs exposes 109 endpoints covering payees, payee invitation, payors operations.
/v2/users/{userId}
Delete a User
/v2/users/{userId}/disable
Disable a User