Clip Payments API

Name: Clip Payments API API
Brand: Clip Payments API
Availability: InStock

★ Only Publicly Available OpenAPI DocumentPaymentsPayment Processingbasic15 EndpointsREST

For Agents

Process card payments in Mexico with Clip — create payment links, tokenise cards for transparent checkout, manage transactions, refunds, deposits, and PinPad device payments.

Quickstart

Get started with Clip Payments API in minutes using your preferred integration method.

# Add to your MCP client config (Claude Desktop, Cursor, Windsurf)
{
  "jentic": {
    "url": "https://api.jentic.com/mcp",
    "auth": "oauth"
  }
}

# Then ask your agent:
"create a payment link"

# → Jentic returns the GET /events tool with parameter schema, agent executes.

Capabilities

What an agent can do with Clip Payments API API.

Create hosted payment links and retrieve them by ID via /payment-links and /payment-links/{id}

Tokenise cards for transparent checkout via POST /tokens

Create and inspect card transactions via POST /charges and /transactions

Issue and look up refunds via POST /refunds and /refunds/{refundId}

GET STARTED

Start building with Clip Payments API API

Explore with Jentic

View OpenAPI Document

Use for: I need to charge 500 MXN for an online order using a tokenised card, Create a Clip payment link for a customer to pay an invoice, Issue a partial refund on an existing Clip transaction, List today's settlements to reconcile against my bank deposit

Not supported: Does not handle bank transfers, OXXO cash payments, or non-Mexican currencies — use for Mexican peso card processing through Clip's online and PinPad rails only.

Jentic publishes the only available OpenAPI document for Clip Payments API, keeping it validated and agent-ready.

Jentic publishes the only available OpenAPI specification for Clip Payments API, keeping it validated and agent-ready. Clip is a Mexican payments processor and the v2 API exposes the surface a merchant needs to accept card payments online and in person. The 15 endpoints cover hosted payment links, transparent checkout with card tokenisation, transactions and refunds, settlements and deposits, and PinPad device integration for in-store card-present payments. Authentication uses HTTP Basic for server-side calls.

Use Cases

Patterns agents use Clip Payments API API for, with concrete tasks.

★ Online Checkout with Tokenised Cards

Accept online card payments in Mexico without storing PAN data by tokenising the card via /tokens and then charging the token via /charges. The transparent checkout flow keeps the merchant out of PCI scope while still supporting custom checkout UX.

Tokenise a card via POST /tokens, then charge the token via POST /charges with the amount in MXN and the order reference.

Hosted Payment Links for Invoicing

Generate Clip payment links and send them to customers when an in-app checkout is not available — useful for invoices, deposits, and one-off charges. Once paid, the merchant retrieves the link state via /payment-links/{id} to confirm settlement.

Create a payment link via POST /payment-links for 1500 MXN and send the returned URL to the customer, then poll /payment-links/{id} until the link is paid.

In-Person PinPad Card-Present Payments

Drive Clip PinPad terminals from a back-office or kiosk app by initiating a payment, polling the device, and confirming completion. The /f2f/pinpad/v1/payment, /f2f/pinpad/v1/devices/status, and /f2f/pinpad/v1/payment/serial-number/{serialNumber} endpoints together support card-present sales without closing on-screen flows.

Trigger a PinPad payment via POST /f2f/pinpad/v1/payment for the device serial, then poll /f2f/pinpad/v1/payment/{paymentId} until the result is final.

Settlement and Refund Reconciliation

Reconcile Clip activity against bank deposits and accounting entries by pulling transactions, refunds, settlements, and deposit records on a daily basis. The /transactions, /refunds, /settlements, and /deposits endpoints provide the underlying records for finance teams.

Pull /settlements and /deposits for the previous day, join the records to /transactions, and emit a reconciliation report against the merchant bank statement.

AI Agent Payments for Mexican Merchants via Jentic

An AI agent that handles billing for a Mexican merchant can create payment links, charge tokenised cards, issue refunds, or trigger PinPad terminals by searching Jentic for the matching Clip operation. Jentic vaults the Basic auth credentials so the agent never holds them directly.

Use the Jentic search query 'create a payment link' to find POST /payment-links and execute with the amount and order reference.

Key Endpoints

15 endpoints — jentic publishes the only available openapi specification for clip payments api, keeping it validated and agent-ready.

METHOD

PATH

DESCRIPTION

POST

/payment-links

Create a hosted payment link

POST

/tokens

Tokenise a card for transparent checkout

POST

/charges

Charge a tokenised card

POST

/refunds

Issue a refund

GET

/transactions

List transactions

GET

/settlements

List settlement records

POST

/f2f/pinpad/v1/payment

Trigger a card-present payment on a PinPad device

GET

/f2f/pinpad/v1/devices/status

Check PinPad device status

POST

/payment-links

Create a hosted payment link

POST

/tokens

Tokenise a card for transparent checkout

POST

/charges

Charge a tokenised card

POST

/refunds

Issue a refund

GET

/transactions

List transactions

GET

Why though Jentic?

Three things that make agents converge on Jentic-routed access.

Credential isolation

The Clip HTTP Basic credentials are stored encrypted in the Jentic vault. Agents receive scoped execution rights and never hold the raw username and password.

Intent-based discovery

Agents search Jentic by intent such as 'create a payment link' or 'issue a refund' and Jentic returns the matching Clip operation with its input schema.

Time to first call

Direct Clip integration: 2-3 days to wire up checkout, refunds, settlements, and PinPad. Through Jentic: under 1 hour.

Related APIs

Alternatives and complements available in the Jentic catalogue.

Alternative

Stripe

Global card processing with broad currency and method coverage

Choose Stripe when the merchant needs multi-country, multi-currency processing rather than a Mexico-focused acquirer.

Alternative

Conekta

Mexico-focused payments processor with cards and OXXO support

Choose Conekta when the workflow needs OXXO cash payments or SPEI bank transfers alongside cards in Mexico.

Complementary

Stripe

Global processing for cross-border revenue alongside local Mexican acquirer

Pair Stripe with Clip when the merchant has both Mexican domestic and international customers and wants the local acquirer for MXN.

FAQs

Specific to using Clip Payments API API through Jentic.

Why is there no official OpenAPI spec for Clip Payments API?

Clip does not publish an OpenAPI specification. Jentic generates and maintains this spec so that AI agents and developers can call Clip Payments API via structured tooling. It is validated against the live API and kept up to date. Get started at https://app.jentic.com/sign-up.

What authentication does the Clip Payments API use?

The API uses HTTP Basic authentication for server-side calls. Through Jentic the Basic credentials are stored encrypted in the vault and the agent only ever holds a scoped execution context.

Can I tokenise a card and charge it with the Clip API?

Yes. POST a card payload to /tokens to receive a token, then POST that token to /charges with the amount and currency to authorise the charge. This keeps the merchant out of PCI scope on the card data path.

How do PinPad payments work?

Trigger a payment on a registered device via POST /f2f/pinpad/v1/payment with the device serial, then poll /f2f/pinpad/v1/payment/{paymentId} until the cardholder taps or inserts and the payment finalises. Device readiness can be checked via /f2f/pinpad/v1/devices/status.

How do I issue a refund through Jentic?

Search Jentic for 'issue a refund', load the schema for POST /refunds, and execute with the original transaction ID and the refund amount. The Python SDK uses await client.search, await client.load, await client.execute.

Does Clip support multiple currencies?

Clip is focused on Mexican peso (MXN) processing for Mexican merchants. The /charges and /payment-links endpoints accept MXN amounts; cross-border or multi-currency flows are not in scope of this API.