EthoswarmEthoswarm
← Back to Bazaar

Stripe Link

Copied!
Wild

REST API for obtaining single-use card and shared payment credentials (SPT) from a user's Link wallet. Enables HTTP 402 Machine Payment Protocol (MPP) flows.

Equipped By
5Minds
Comprised Of
11App Tools
App Tools
11
CompleteUCPCheckoutPOST

Completes a UCP checkout using an approved Link SpendRequest and may move real money when test is false or omitted. Use only after showing the user the exact seller, items, quantities, currency, final total, and fulfillment details and receiving a fresh explicit confirmation for this checkout. checkout_id, spend_request_id, and profile_id must refer to the same frozen operation. Execute a confirmed checkout at most once. Never retry automatically after a timeout or unknown result; retrieve the checkout first. This tool is inserted inactive until test-mode and server-side confirmation/idempotency controls are verified.

CreateSpendRequestPOST

Creates a spend request describing a purchase the mind wants to make. Use this ONLY for 'card' credentials. Do not use for HTTP 402 / SPT.

CreateSPTSpendRequestPOST

Creates a spend request for an HTTP 402 Machine Payment Protocol (shared_payment_token).

CreateUCPCheckoutPOST

Creates a UCP checkout session for products already selected from SearchUCPCatalog. This operation creates checkout state but does not itself charge the user. Use one seller profile_id and line_items whose sku_id values come from variants belonging to that same profile. After creation, present the returned items, currency, amount_total, fulfillment details, and expiration to the user. Do not create or complete a payment if the returned total differs from the expected total. Use test=true for a self-contained demo checkout.

DecodePaymentChallengePOST

Decodes an HTTP 402 WWW-Authenticate payment challenge to extract network_id and amount for an SPT.

GetSpendRequestGET

Retrieves the current state of a spend request. Poll this periodically until status is 'approved'.

GetUCPCheckoutGET

Retrieves a UCP checkout session together with its associated SpendRequest. This operation is read-only and does not complete or charge the checkout. Use the checkout_id returned by CreateUCPCheckout and the exact associated spend_request_id. Inspect status, amount_total, currency, expiration, fulfillment, order details, and SpendRequest state. Stop on completed or expired; if requires_action is returned, surface the required action instead of treating it as success.

ListPaymentMethodsGET

Fetches all saved payment instruments associated with the human's Link wallet. The mind must call this prior to creating a spend request to select a valid funding source ID (payment_details parameter) to back the newly minted one-time card.

PayMachineMerchantPOST

Drives the full HTTP 402 / MPP flow against a merchant URL using an already-approved SPT spend request.

RequestApprovalPOST

Transitions a spend request from 'created' to 'pending_approval', triggering the generation of an interactive approval URL.

SearchUCPCatalogGET

Searches the authenticated Stripe Link Universal Commerce Protocol catalog without creating a checkout or charging the user. Call this before checkout to discover products and seller variants. Results can be grouped by product; checkout-critical values such as profile_id, merchant_sku, price, currency, and availability may be inside each variants item. Keep those values from the same variant together and never combine a SKU, price, or profile from different results. Use test=true for synthetic demo data.

Overview

REST API for obtaining single-use card and shared payment credentials (SPT) from a user's Link wallet. Enables HTTP 402 Machine Payment Protocol (MPP) flows. It gives your AI agent 11 built-in tools, including complete ucpcheckout, create spend request and create sptspend request. Apps are free to equip, and once equipped your AI Mind can use Stripe Link automatically while it works. Stripe Link is currently equipped on 5 Minds.

Read the integration guide: AI Agent for Stripe →

Frequently asked questions

What is Stripe Link?

REST API for obtaining single-use card and shared payment credentials (SPT) from a user's Link wallet. Enables HTTP 402 Machine Payment Protocol (MPP) flows. It bundles 11 tools your AI agent can call on your behalf.

What can Stripe Link do for my AI agent?

Once equipped, your AI Mind can use Stripe Link to complete ucpcheckout, create spend request, create sptspend request, create ucpcheckout and decode payment challenge, and more — without you having to do any of it manually.

How do I connect Stripe Link to my AI Mind?

Open Stripe Link 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 Stripe Link free?

Yes — Stripe Link is free to equip on your AI Mind in the Ethoswarm Bazaar.