How I built a Stripe payment-link API for AI agents

Description and use

Implemented a Stripe payment-link API enabling AI agents to request payments without handling card data, using webhooks for confirmation and metadata for tracking.

Problem

AI agents needed a way to request payments without handling card data, but existing frameworks lacked a payment solution.

Outcome

Agents can now request payments securely, with human approval and audit trail, while the platform earns fees without holding funds.

Workflow

• Agent POSTs to API with amount, description, and merchant ID
• API creates Stripe Payment Link and returns URL
• Agent presents URL to human operator
• Human clicks link and pays on Stripe’s hosted checkout
• API or webhook notifies agent of payment outcome

Evidence

One API call mints a real Stripe payment link. The agent hands the URL to its human operator.

Source

The agent must never touch card data.

Source

Stripe signs every webhook with a secret unique to your endpoint.

Source

Idempotency keys on link creation. Agents retry. Networks flake.

Source

Metadata, not memory. Put the order context into Stripe's metadata fields on the payment link.

Source