Stripe

Stripe Payment Intents API

A PaymentIntent guides you through the process of collecting a payment from your customer. We recommend that you create exactly one PaymentIntent for each order or customer session in your system. You can reference the PaymentIntent later to see the history of payment attempts for a particular session.

GitHub OpenAPI
Business capability
Payment Initiation Management BC-1340.10

Operations 11

Each operation below carries the questions people ask an LLM about it and the instructions they give an agent to run it. Generated by API Evangelist overlay

GET /v1/payment_intents List payments in progress and completed · Get payment intents #
Ask an LLM
“How do I list recent PaymentIntents on my account?”
“Can I see only the PaymentIntents for one customer?”
Tell an agent
List my most recent PaymentIntents.
List the PaymentIntents for customer {customer}.
POST /v1/payment_intents Start a payment for an amount · Post payment intents #
Ask an LLM
“How do I start collecting a payment from a customer in Stripe?”
“Can I authorize a card now and capture the money later?”
Tell an agent
Create a PaymentIntent for {amount} {currency}.
Charge customer {customer} {amount} {currency} with payment method {payment_method} and confirm it now.
GET /v1/payment_intents/search Search payments with a query · Get payment intents search #
Ask an LLM
“How do I search for payments by status, amount or metadata?”
“How quickly does a new payment show up in search results?”
Tell an agent
Search PaymentIntents matching {query}.
Find payments where {query} and return {limit} results.
GET /v1/payment_intents/{intent} Get a PaymentIntent · Get payment intents intent #
Ask an LLM
“How do I check the status of one payment?”
“Can my front end fetch a PaymentIntent with a publishable key?”
Tell an agent
Show PaymentIntent {intent}.
Fetch PaymentIntent {intent} client-side using secret {client_secret}.
POST /v1/payment_intents/{intent} Change a payment before it is confirmed · Post payment intents intent #
Ask an LLM
“How do I change the amount of a payment before the customer pays?”
“Do I need to confirm a PaymentIntent again after switching its payment method?”
Tell an agent
Change the amount on PaymentIntent {intent} to {amount}.
Attach customer {customer} to PaymentIntent {intent}.
POST /v1/payment_intents/{intent}/apply_customer_balance Pay a PaymentIntent from the customer's cash balance · Post payment intents intent apply customer balance #
Ask an LLM
“How do I use money in a customer's cash balance to settle a payment?”
“Can I apply only part of the customer's cash balance to a payment?”
Tell an agent
Apply the customer's cash balance to PaymentIntent {intent}.
Apply {amount} {currency} of cash balance to PaymentIntent {intent}.
POST /v1/payment_intents/{intent}/cancel Cancel a payment · Post payment intents intent cancel #
Ask an LLM
“How do I cancel a payment the customer hasn't finished?”
“What happens to an authorized but uncaptured amount when I cancel?”
Tell an agent destructive · confirm first
Cancel PaymentIntent {intent}.
Cancel payment {intent} with reason {cancellation_reason}.
POST /v1/payment_intents/{intent}/capture Capture an authorized payment · Post payment intents intent capture #
Ask an LLM
“How do I collect the money from a payment I only authorized?”
“Can I capture less than the amount I authorized?”
Tell an agent
Capture PaymentIntent {intent}.
Capture {amount_to_capture} of authorized payment {intent}.
POST /v1/payment_intents/{intent}/confirm Confirm a payment and attempt the charge · Post payment intents intent confirm #
Ask an LLM
“How do I confirm a payment so the customer is actually charged?”
“What happens if the customer's bank requires extra authentication?”
Tell an agent
Confirm PaymentIntent {intent}.
Confirm payment {intent} with payment method {payment_method}.
POST /v1/payment_intents/{intent}/increment_authorization Increase the authorized amount on a card payment · Post payment intents intent increment authorization #
Ask an LLM
“How do I raise the amount held on a customer's card before capturing?”
“Can an incremental authorization be declined?”
Tell an agent
Increase the authorization on PaymentIntent {intent} to {amount}.
Raise the held amount on payment {intent} to {amount} with note {description}.
POST /v1/payment_intents/{intent}/verify_microdeposits Verify bank microdeposits for a payment · Post payment intents intent verify microdeposits #
Ask an LLM
“How do I verify a customer's bank account with microdeposits before a payment?”
“Can I verify microdeposits with the descriptor code instead of the two amounts?”
Tell an agent
Verify microdeposits on PaymentIntent {intent} with amounts {amounts}.
Verify the bank account on payment {intent} using descriptor code {descriptor_code}.

Documentation

📖
Documentation
https://stripe.com/docs/api/payment_intents
📖
APIReference
https://docs.stripe.com/api/payment_intents

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/stripe/refs/heads/main/openapi/stripe-payment-intents-api-openapi.yml

Other Resources

🔗
Overlay
https://raw.githubusercontent.com/api-evangelist/stripe/refs/heads/main/overlays/stripe-payment-intents-overlay.yaml

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/stripe-payment-intents-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

stripe-payment-intents-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Stripe Payment Intents API
  description: Needs description.
  contact:
    email: dev-platform@stripe.com
    name: Stripe Dev Platform Team
    url: https://stripe.com
  termsOfService: https://stripe.com/us/terms/
  version: '2023-10-16'
  x-stripeSpecFilename: spec3
servers:
- url: https://api.stripe.com/
security:
- basicAuth: []
- bearerAuth: []
tags:


# --- truncated at 32 KB (206 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/stripe/refs/heads/main/openapi/stripe-payment-intents-api-openapi.yml