Skip to content
Sign in
An image of the Stripe logo
Create account
Sign in
Home
Payments
Finance automation
Banking as a service
Developer tools
No-code
All products
Home
Payments
Finance automation
Home
Payments
Finance automation
Banking as a service
Developer tools
Overview
Issuing cards
    Overview
    Global Issuing
    Get started
    How Issuing works
    Choose your card offering
    Customize your program
    Add funds to your card program
    Manage fraud
    Cards
    Create cards
    Virtual cards
    Physical cards
    Manage cards
    Digital wallets
    Replacement cards
    Testing and support
    Testing physical cards
    Support
    Controls
    Spending controls
    Real-time authorizations
    SMS fraud alerts
    3D Secure
    PIN management
    Issuing Elements
    Token Management
    Funding
    Balance
    Issuing with Connect
    Set up an Issuing and Connect integration
    Connect funding
    Connected accounts cardholders and cards
    Purchases
    Authorizations
    Transactions
    Disputes
    Testing
    Merchant categories
    Additional information
    Choose a cardholder type
    Marketing guidance (Europe/UK)
    Product and marketing compliance guidance (US)
Treasury
Business financing
Issuing
·
HomeBanking as a serviceIssuing cards

Testing Issuing

Learn how to test your integration and simulate purchases.

Testing payments

Refer to the testing documentation to learn more about testing your Stripe integration.

You can issue cards and simulate purchases using your own Stripe integration in test mode. This allows you to test your integration before you go live without having to make real purchases. You can only use these cards for testing within your Stripe account and not for external purchases.

Caution

When testing your authorization endpoint, make sure that you have set the endpoint for test mode in your Issuing settings. Toggle View test data to switch between test and live mode data and settings.

Funding your test mode Issuing balance

Before creating test mode transactions, you must add test mode funds to the Issuing balance on your account. These aren’t real funds, and you can only use them for simulating purchases in test mode.

Issuing users in the US

Issuing users in the US use “pull” funding, and use Top-ups to fund their Issuing balance. You can create test mode top-ups in the Dashboard, or with the Top-ups API. Read more about funding Issuing balances for US users.

Issuing users in the UK and euro area

To top up their balance, Issuing users in the UK and Europe “push” funds using Funding Instructions. You can do this in the test mode Dashboard, or with the Funding Instructions API. Read more about funding Issuing balances for UK and euro area users.

You can simulate a card purchase by specifying authorization details in the Dashboard.

Create a card
Dashboard

Use the API or Dashboard to create a cardholder and card in test mode.

Create a test authorization
Dashboard

In the Dashboard, first make sure you’re viewing test data. Go to the Issuing Cards page, find your newly-created card, and scroll to the Authorizations section. Then click Create test authorization.

In some cases (such as fuel or hotel authorizations) you may be able to control the amount when approving the authorization. Check the Authorization amount is controllable box in order to enable this functionality.

Click submit to create the authorization. If you’ve configured your synchronous webhook, you can use it to approve or decline. The browser will redirect to the page for the newly-created authorization.

Creating a capture
Dashboard

To create a test capture with an authorization in the Dashboard, make sure you’re viewing test data and complete the following steps:

  1. Go to the Authorizations page under Issued Cards.
  2. Click the authorization you want to capture, then Capture.

You can capture an authorization for an amount below, more than or equal to what’s been authorized. You can also capture multiple times irrespective of what state the authorization is in.

Enter the amount you want to capture and click Submit to create the capture. The browser will redirect you to the Authorizations page with the captured authorization selected.

You can also capture funds with a force capture. Force captures are captures initiated despite receiving a declined authorization, or even without an authorization.

  1. Go to the Overview page under Issued Cards.
  2. Go to the Transactions section on the page and click Create force capture.

You can force capture any amount.

Enter the amount you want to capture and click Submit to create the force capture. The browser redirects you to the Transactions page with the transaction selected.

Viewing transaction details
Dashboard

A corresponding transaction is created when the authorization is captured. You can view more details on the Transactions page in the Dashboard.

Was this page helpful?
Need help? Contact Support.
Watch our developer tutorials.
Check out our product changelog.
Questions? Contact Sales.
Powered by Markdoc
You can unsubscribe at any time. Read our privacy policy.
On this page
Funding your test mode Issuing balance
Create a card
Create a test authorization
Creating a capture
Viewing transaction details
Stripe Shell
Test mode
Welcome to the Stripe Shell! Stripe Shell is a browser-based shell with the Stripe CLI pre-installed. Login to your Stripe account and press Control + Backtick on your keyboard to start managing your Stripe resources in test mode. - View supported Stripe commands: - Find webhook events: - Listen for webhook events: - Call Stripe APIs: stripe [api resource] [operation] (e.g. )
The Stripe Shell is best experienced on desktop.
$