# `Method.stripe.charge` \[One-time payments via Shared Payment Tokens] The `charge` intent for the Stripe payment method. Requests a one-time payment using [Shared Payment Tokens (SPTs)](https://docs.stripe.com/agentic-commerce/concepts/shared-payment-tokens). ## Usage ```ts twoslash import Stripe from 'stripe' import { Mppx, stripe } from 'mppx/server' const stripeClient = new Stripe(process.env.STRIPE_SECRET_KEY!) const mppx = Mppx.create({ methods: [stripe.charge({ client: stripeClient, networkId: 'internal', paymentMethodTypes: ['card'], })], }) export async function handler(request: Request) { // [!code focus:start] const response = await mppx.charge({ amount: '1', currency: 'usd', decimals: 2, description: 'Premium API access', })(request) // [!code focus:end] if (response.status === 402) return response.challenge return response.withReceipt(Response.json({ data: '...' })) } ``` ## Return type Returns a function that accepts a `Request` and returns a response object with payment status. ```ts type ReturnType = (request: Request) => Promise< | { status: 402; challenge: Response } | { status: 200; withReceipt: (response: T) => T } > ``` ## Configuration These parameters configure the `stripe.charge()` constructor. You must provide either `client` or `secretKey`. ### client * **Type:** `StripeClient` Pre-configured Stripe SDK instance. Any object matching the duck-typed `StripeClient` shape works. Using `client` is recommended — it lets you configure retries, API version, and other options. ```ts twoslash import Stripe from 'stripe' import { stripe } from 'mppx/server' const stripeClient = new Stripe(process.env.STRIPE_SECRET_KEY!) const method = stripe.charge({ client: stripeClient, // [!code focus] networkId: 'internal', paymentMethodTypes: ['card'], }) ``` ### secretKey * **Type:** `string` Stripe secret API key. When provided instead of `client`, mppx makes raw API calls to Stripe. ```ts twoslash import { stripe } from 'mppx/server' const method = stripe.charge({ secretKey: process.env.STRIPE_SECRET_KEY!, // [!code focus] networkId: 'internal', paymentMethodTypes: ['card'], }) ``` ### networkId * **Type:** `string` Stripe [Business Network](https://docs.stripe.com/get-started/account/profile) profile ID. ### paymentMethodTypes * **Type:** `string[]` Allowed Stripe payment method types (e.g. `['card']`, `['card', 'link']`). ### metadata (optional) * **Type:** `Record` Key-value pairs forwarded to Stripe. Appears in the Challenge and attaches to the Stripe `PaymentIntent`. ## Request parameters ### amount * **Type:** `string` Payment amount in human-readable units. ### currency * **Type:** `string` ISO currency code (e.g. `'usd'`). ### decimals * **Type:** `number` Number of decimal places in the amount (e.g. `2` for cents). ### description (optional) * **Type:** `string` Human-readable description of the payment request.