Legacy
Working with Stripe Issuing cards Legacy
Learn how to integrate Stripe Issuing with Treasury for platforms.
Legacy integration
The v1 version of Treasury for platforms is a legacy integration that doesn’t support many of the features introduced in Treasury for platforms v2. Don’t build a new v1 integration.
There’s also a compatibility consideration if you’re using the Accounts v2 API.
Accounts v2 API compatibility
The Accounts v2 API doesn’t support Issuing workflows. If you have accounts created with Accounts v2, you can use Accounts v1 to manage the treasury and card_issuing capabilities. For details, see Use Accounts as customers.
Stripe Issuing lets you create physical and virtual cards using a financial account as the source of funds.
Enable Issuing on connected accounts
Request the card_issuing account capability for the connected accounts on your platform and provide the required information for onboarding.
Command Line
Select a language
cURL
Stripe CLI
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
If successful, the response returns the connected account Account object with the capabilities hash listing the requested capabilities as active.
If you haven’t already, also request access to the card_issuing feature on the financial account.
Command Line
Select a language
cURL
Stripe CLI
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
If successful, the response returns the financial account object with the features listed in the active_features or pending_features array.
Create a card
After the card_issuing capability is active, the sellers and service providers that own your platform’s connected accounts can create cardholders and cards. You can issue cards only through the API.
A Cardholder object represents an individual or business entity that you can issue cards to. You can begin by creating a Cardholder with name, billing information, and whether they’re an individual or company.
Command Line
Select a language
cURL
Stripe CLI
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
If successful, the response returns the newly created Cardholder object.
Create a Card and assign it to both the Cardholder you just created and a financial account. To assign the cardholder and financial account, specify the cardholder ID in the cardholder parameter and the financial account ID in the financial_account parameter of the /the relevant part of the product request.
Command Line
Select a language
cURL
Stripe CLI
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
If successful, the response returns the newly created Card object.
Handle authorizations
Review the Issuing authorizations guide to properly handle authorizations.
Create test authorizations
You can test the cards you just issued by following the steps in Testing Issuing to simulate purchases.
If the financial account associated with the issued card has outbound_flows restricted, authorizations on the card aren’t allowed.
See the Issuing transactions guide for information on different transaction types you might test against.
Handle captures and refunds
See the Issuing transactions guide to learn how to handle refunds and captures.
Handle disputes
See the Issuing disputes guide to learn how to properly handle disputes.