experimental_StripePaymentIntentPlugin

Adds Stripe PaymentIntent creation and validation to an AixyzApp, providing an alternative payment method alongside x402.

import { experimental_StripePaymentIntentPlugin } from "@aixyz/stripe";

This API is experimental and may change significantly in future releases.

Installation

bun add @aixyz/stripe

Usage

await server.withPlugin(new experimental_StripePaymentIntentPlugin());

Environment Variables

Variable	Required	Default	Description
`STRIPE_SECRET_KEY`	Yes	—	Stripe secret key
`STRIPE_PRICE_CENTS`	No	`100`	Price per request in USD cents

If STRIPE_SECRET_KEY is not set, the function is a no-op — no endpoints or middleware are registered.

Registered Endpoints

`POST /stripe/create-payment-intent`

Creates a new Stripe PaymentIntent for the configured price. Response:

{
  "clientSecret": "pi_xxx_secret_xxx",
  "paymentIntentId": "pi_xxx"
}

Payment Middleware

After registering the experimental_StripePaymentIntentPlugin, the server checks incoming requests for the x-stripe-payment-intent-id header:

If the header is present, it validates the PaymentIntent:
- Status must be succeeded
- Amount must meet the configured STRIPE_PRICE_CENTS
- Payment must not have been already consumed
Valid payments are marked as consumed (one-time use) and the request proceeds
Invalid payments return 402 Payment Required
If no header is present, the request falls through to x402 middleware

Usage

Use in a custom server (app/server.ts):

app/server.ts

import { AixyzApp } from "aixyz/app";
import { IndexPagePlugin } from "aixyz/app/plugins/index-page";
import { A2APlugin } from "aixyz/app/plugins/a2a";
import { experimental_StripePaymentIntentPlugin } from "@aixyz/stripe";
import * as agent from "./agent";

const server = new AixyzApp();

await server.withPlugin(new IndexPagePlugin());

// Register Stripe before other plugins so the Stripe middleware runs first
await server.withPlugin(new experimental_StripePaymentIntentPlugin());

await server.withPlugin(new A2APlugin([{ exports: agent }]));

await server.initialize();

export default server;

Register the experimental_StripePaymentIntentPlugin before A2A or MCP plugins so the Stripe middleware runs first. If a valid Stripe payment is found, x402 verification is skipped.

Getting Started

CLI

Config

File-system layout

Functions

Protocols

experimental_StripePaymentIntentPlugin

Installation

Usage

Environment Variables

Registered Endpoints

`POST /stripe/create-payment-intent`

Payment Middleware

Usage

​Installation

​Usage

​Environment Variables

​Registered Endpoints

​POST /stripe/create-payment-intent

​Payment Middleware

​Usage

Installation

Usage

Environment Variables

Registered Endpoints

`POST /stripe/create-payment-intent`

Payment Middleware

Usage