Stripe

Stripe Issuing API

An API for businesses to instantly create, manage, and distribute payment cards.

GitHub OpenAPI
Business capability
Card Issuance Management BC-1340.60

Operations 27

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/issuing/authorizations List card authorization requests · Get issuing authorizations #
Ask an LLM
“How do I see every authorization attempt made on the cards I've issued?”
“Can I filter issued-card authorizations by cardholder or by status like pending or closed?”
Tell an agent
List the latest authorizations on issued cards.
Show authorizations on card {card} with status {status}.
GET /v1/issuing/authorizations/{authorization} Look up one card authorization · Get issuing authorizations authorization #
Ask an LLM
“How do I pull up the details of a single authorization on an issued card?”
“What did one specific issued-card authorization look like when it came in?”
Tell an agent
Get authorization {authorization}.
Show me the details of issued-card authorization {authorization}.
POST /v1/issuing/authorizations/{authorization} Tag a card authorization with metadata · Post issuing authorizations authorization #
Ask an LLM
“Can I attach my own reference data to an issued-card authorization?”
“How do I label an authorization so my accounting system can match it later?”
Tell an agent
Add metadata {metadata} to authorization {authorization}.
Update the metadata on issued-card authorization {authorization}.
POST /v1/issuing/authorizations/{authorization}/approve Approve a pending card authorization · Post issuing authorizations authorization approve #
Ask an LLM
“How do I approve a pending purchase on one of my issued cards in real time?”
“Can I approve an issued-card authorization for less than the requested amount?”
Tell an agent
Approve pending authorization {authorization}.
Approve authorization {authorization} for {amount} only.
POST /v1/issuing/authorizations/{authorization}/decline Decline a pending card authorization · Post issuing authorizations authorization decline #
Ask an LLM
“How do I decline a purchase attempt on an issued card before it goes through?”
“Is there a time window for declining a pending issued-card authorization?”
Tell an agent destructive · confirm first
Decline pending authorization {authorization}.
Reject the purchase attempt on authorization {authorization} and note why in metadata {metadata}.
GET /v1/issuing/cardholders List cardholders · Get issuing cardholders #
Ask an LLM
“How do I see all the people and companies I've set up to receive issued cards?”
“Can I find a cardholder by email or phone number?”
Tell an agent
List all my cardholders.
Find the cardholder with email {email}.
POST /v1/issuing/cardholders Create a cardholder · Post issuing cardholders #
Ask an LLM
“How do I register a person or company so I can issue them a card?”
“What billing address details does a new cardholder need?”
Tell an agent
Create a cardholder named {name} with email {email} and billing address {billing}.
Add a new {type} cardholder called {name}.
GET /v1/issuing/cardholders/{cardholder} Look up a cardholder · Get issuing cardholders cardholder #
Ask an LLM
“How do I view the profile and billing details of one cardholder?”
“What spending controls are set on a particular cardholder?”
Tell an agent
Get cardholder {cardholder}.
Show me the details for cardholder {cardholder}.
POST /v1/issuing/cardholders/{cardholder} Update a cardholder · Post issuing cardholders cardholder #
Ask an LLM
“How do I change a cardholder's email, phone or billing address?”
“Can I deactivate a cardholder or change their spending limits?”
Tell an agent
Change the email of cardholder {cardholder} to {email}.
Set cardholder {cardholder} status to {status}.
GET /v1/issuing/cards List issued cards · Get issuing cards #
Ask an LLM
“How do I see every card I've issued?”
“Can I find an issued card by its last four digits or expiry date?”
Tell an agent
List all my issued cards.
Find the issued card ending in {last4}.
POST /v1/issuing/cards Issue a new card · Post issuing cards #
Ask an LLM
“How do I issue a virtual or physical card to a cardholder?”
“Can I issue a replacement for a lost or stolen card?”
Tell an agent
Issue a {type} card in {currency} to cardholder {cardholder}.
Issue a replacement for card {replacement_for} because it was {replacement_reason}.
GET /v1/issuing/cards/{card} Look up an issued card · Get issuing cards card #
Ask an LLM
“How do I check the status and spending controls of one issued card?”
“What details can I see about a single card I issued?”
Tell an agent
Get issued card {card}.
Show me the status of card {card}.
POST /v1/issuing/cards/{card} Update or freeze an issued card · Post issuing cards card #
Ask an LLM
“How do I freeze or cancel an issued card?”
“Can I change the PIN or spending limits on a card I've already issued?”
Tell an agent
Set card {card} status to {status}.
Cancel card {card} as {cancellation_reason}.
GET /v1/issuing/disputes List issued-card disputes · Get issuing disputes #
Ask an LLM
“How do I see all the disputes I've opened on issued-card transactions?”
“Can I filter my issued-card disputes by status, like submitted or won?”
Tell an agent
List my issued-card disputes.
Show disputes with status {status}.
POST /v1/issuing/disputes Open a dispute on a card transaction · Post issuing disputes #
Ask an LLM
“How do I dispute a charge made on one of my issued cards?”
“Do I need all the evidence ready before I open an issued-card dispute?”
Tell an agent
Open a dispute on transaction {transaction}.
Dispute {amount} of transaction {transaction} with evidence {evidence}.
GET /v1/issuing/disputes/{dispute} Look up an issued-card dispute · Get issuing disputes dispute #
Ask an LLM
“How do I check where one of my issued-card disputes stands?”
“What evidence is currently attached to a dispute I opened?”
Tell an agent
Get issued-card dispute {dispute}.
Show me the status and evidence of dispute {dispute}.
POST /v1/issuing/disputes/{dispute} Update evidence on a card dispute · Post issuing disputes dispute #
Ask an LLM
“How do I add or change evidence on an issued-card dispute before submitting it?”
“Can I change the disputed amount after opening the dispute?”
Tell an agent
Update the evidence on dispute {dispute} to {evidence}.
Change the disputed amount on {dispute} to {amount}.
POST /v1/issuing/disputes/{dispute}/submit Submit a card dispute to the network · Post issuing disputes dispute submit #
Ask an LLM
“How do I send an issued-card dispute to the card network once the evidence is ready?”
“What happens if required evidence is missing when I submit a dispute?”
Tell an agent
Submit dispute {dispute} to the card network.
File issued-card dispute {dispute} now that the evidence is complete.
GET /v1/issuing/settlements List issuing settlements · Get issuing settlements #
Ask an LLM
“How do I see the settlements for my card issuing program?”
“Can I list issuing settlements from a specific date range?”
Tell an agent
List my recent issuing settlements.
Show issuing settlements created in {created}.
GET /v1/issuing/settlements/{settlement} Look up an issuing settlement · Get issuing settlements settlement #
Ask an LLM
“How do I view the details of one issuing settlement?”
“What does a single card-network settlement for my issued cards contain?”
Tell an agent
Get issuing settlement {settlement}.
Show me settlement {settlement}.
POST /v1/issuing/settlements/{settlement} Tag an issuing settlement with metadata · Post issuing settlements settlement #
Ask an LLM
“Can I attach my own notes or reference IDs to an issuing settlement?”
“How do I label a settlement for reconciliation?”
Tell an agent
Add metadata {metadata} to settlement {settlement}.
Update the metadata on issuing settlement {settlement}.
GET /v1/issuing/tokens List digital wallet tokens for a card · Get issuing tokens #
Ask an LLM
“How do I see which digital wallets an issued card has been added to?”
“Can I list only the active or suspended tokens on a card?”
Tell an agent
List the tokens for card {card}.
Show tokens on card {card} with status {status}.
GET /v1/issuing/tokens/{token} Look up a card token · Get issuing tokens token #
Ask an LLM
“How do I get the details of one token created for an issued card?”
“What status is a particular card token in?”
Tell an agent
Get issuing token {token}.
Show me the status of token {token}.
POST /v1/issuing/tokens/{token} Suspend or reactivate a card token · Post issuing tokens token #
Ask an LLM
“How do I suspend a card token in a digital wallet without cancelling the card?”
“Can I reactivate a suspended token or permanently deactivate it?”
Tell an agent
Set token {token} status to {status}.
Suspend token {token}.
GET /v1/issuing/transactions List issued-card transactions · Get issuing transactions #
Ask an LLM
“How do I see all the completed purchases and refunds on my issued cards?”
“Can I list transactions for a single card or cardholder?”
Tell an agent
List recent issued-card transactions.
List transactions on card {card}.
GET /v1/issuing/transactions/{transaction} Look up an issued-card transaction · Get issuing transactions transaction #
Ask an LLM
“How do I get the details of one purchase made on an issued card?”
“What information is recorded for a single issuing transaction?”
Tell an agent
Get issuing transaction {transaction}.
Show me the details of card transaction {transaction}.
POST /v1/issuing/transactions/{transaction} Tag a card transaction with metadata · Post issuing transactions transaction #
Ask an LLM
“Can I attach an expense code or note to an issued-card transaction?”
“How do I label a card transaction for bookkeeping?”
Tell an agent
Add metadata {metadata} to transaction {transaction}.
Update the metadata on issued-card transaction {transaction}.

Documentation

📖
Documentation
https://stripe.com/docs/issuing

Specifications

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

Schemas & Data

📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/stripe/refs/heads/main/json-schema/stripe-post-issuing-cardholders-request-schema.json
📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/stripe/refs/heads/main/json-schema/stripe-post-issuing-cardholders-cardholder-request-schema.json
📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/stripe/refs/heads/main/json-schema/stripe-post-issuing-cards-request-schema.json
📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/stripe/refs/heads/main/json-schema/stripe-post-issuing-cards-card-request-schema.json
📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/stripe/refs/heads/main/json-schema/stripe-issuing-authorization-schema.json
📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/stripe/refs/heads/main/json-schema/stripe-post-issuing-disputes-request-schema.json

Other Resources

🔗
Overlay
https://raw.githubusercontent.com/api-evangelist/stripe/refs/heads/main/overlays/stripe-issuing-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:stripe-issuing-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-issuing-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Stripe Issuing 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 (311 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/stripe/refs/heads/main/openapi/stripe-issuing-api-openapi.yml