EthoswarmEthoswarm
← Back to Bazaar

VISA Clink Payments

Copied!
Verified

VISA Clink Payments app for agentic digital visa cards. Provides tools for server time, card binding links, direct charges, and session-based charges via the Clink by VISA API. Users authenticate with their Clink API key (X-API-KEY header). Use Clink_GetServerTime to obtain the timestamp required for every transaction call — call it FIRST, then use its epoch_ms_string as the X-Timestamp for all other tools.

Equipped By
1Minds
Comprised Of
4App Tools
App Tools
4
Clink_ChargeDirectPOST

Creates a one-time direct payment using an existing payment instrument. Two modes: (1) Price-based - provide productId and priceId for predefined product pricing, or (2) Amount-based - provide amount and currency for direct charging. At least one customer identifier (customerId or customerEmail) is required. paymentInstrumentId and paymentMethodType are always required. Call Clink_GetServerTime first to obtain the X-Timestamp. The response includes orderId, sessionId, payment status (1=success, 2=pending, 3=failure, 5=next_action_required), and any redirect/action data for 3DS or wallet flows.

Clink_ChargeSessionPOST

Creates an agent payment session for session-based charging. The session binds the amount, currency, and customer email together. Returns a sessionId and expiration time. The sessionId can then be used with Clink_ChargeDirect or clink-cli pay --session-id for actual payment execution. This is the recommended flow for agent-initiated payments where the merchant server pre-creates a session before payment execution. Call Clink_GetServerTime first to obtain the X-Timestamp.

Clink_GetBindingLinkGET

Retrieves a card binding link URL for a Clink customer to add or manage their VISA payment cards. Also refreshes and returns the current list of payment methods (paymentMethodsVoList). The binding URL should be sent to the user to complete card setup in their browser. Call Clink_GetServerTime first to obtain the X-Timestamp required for authentication. The customer is identified by their configured API key and the customerId parameter.

Clink_GetServerTimeGET

Fetch the current server clock as Unix epoch MILLISECONDS via GET https://creator-hub.fly.dev/now — a PUBLIC, unauthenticated endpoint. PURPOSE: provides the X-Timestamp value required by all other Clink API calls. Clink's X-Timestamp accepts only a ~[now-90s, now+2min] window. Call this FIRST, then COPY its response field 'epoch_ms_string' VERBATIM into the 'timestamp' parameter of the very next Clink_* call. Response JSON: {epoch_ms:number, epoch_ms_string:'13-digit string', iso8601:'UTC ISO string'}. Use epoch_ms_string. This endpoint moves NO money and carries NO secrets; safe to call as often as needed.

Overview

VISA Clink Payments app for agentic digital visa cards. Provides tools for server time, card binding links, direct charges, and session-based charges via the Clink by VISA API. Users authenticate with their Clink API key (X-API-KEY header). Use Clink_GetServerTime to obtain the timestamp required for every transaction call — call it FIRST, then use its epoch_ms_string as the X-Timestamp for all other tools. It gives your AI agent 4 built-in tools, including clink charge direct, clink charge session and clink get binding link. Apps are free to equip, and once equipped your AI Mind can use VISA Clink Payments automatically while it works. VISA Clink Payments is currently equipped on 1 Mind.

Frequently asked questions

What is VISA Clink Payments?

VISA Clink Payments app for agentic digital visa cards. Provides tools for server time, card binding links, direct charges, and session-based charges via the Clink by VISA API. Users authenticate with their Clink API key (X-API-KEY header). Use Clink_GetServerTime to obtain the timestamp required for every transaction call — call it FIRST, then use its epoch_ms_string as the X-Timestamp for all other tools. It bundles 4 tools your AI agent can call on your behalf.

What can VISA Clink Payments do for my AI agent?

Once equipped, your AI Mind can use VISA Clink Payments to clink charge direct, clink charge session, clink get binding link and clink get server time — without you having to do any of it manually.

How do I connect VISA Clink Payments to my AI Mind?

Open VISA Clink Payments in the Ethoswarm Bazaar and select Equip to add it to one of your AI Minds. Your Mind can then use it automatically. Some apps ask you to authorize access the first time they run.

Is VISA Clink Payments free?

Yes — VISA Clink Payments is free to equip on your AI Mind in the Ethoswarm Bazaar.