Testing Stripe Issuing Invite only

Test your integration before going live by issuing cards and simulating purchases in test mode.

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 and issue cards that can be used to make real purchases.

Before you create issuing test mode transactions, fund your issuing balance with test mode top ups. You can only use these cards for testing within your Stripe account and not for external purchases.

Simulating purchases

You can simulate a card purchase using your test API keys with the following process:

Fund your issuing balance
Create a cardholder
Create a card
Retrieve the new card’s details
Create a Source object using the card
Create an uncaptured charge using the source

Step 1: Fund your issuing balance

To fund your issuing balance, create a top up with the destination_balance set to “issuing”.

Step 2: Create a cardholder

Create a cardholder with a name, billing address, and entity type. You can also provide additional information, if necessary.

curl https://api.stripe.com/v1/issuing/cardholders \
-u sk_test_4eC39HqLyjWDarjtT1zdp7dc: \
-d name="Jenny Rosen" \
-d email="jenny.rosen@example.com" \
-d phone_number="+18008675309" \
-d status=active \
-d type=individual \
-d "billing[name]"="Jenny Rosen" \
-d "billing[address][line1]"="1234 Main Street" \
-d "billing[address][city]"="San Francisco" \
-d "billing[address][state]"=CA \
-d "billing[address][postal_code]"=94111 \
-d "billing[address][country]"=US

# Set your secret key. Remember to switch to your live secret key in production!
# See your keys here: https://dashboard.stripe.com/account/apikeys
Stripe.api_key = 'sk_test_4eC39HqLyjWDarjtT1zdp7dc'

cardholder = Stripe::Issuing::Cardholder.create({
  name: 'Jenny Rosen',
  email: 'jenny.rosen@example.com',
  phone_number: '+18008675309',
  status: 'active',
  type: 'individual',
  billing: {
    name: 'Jenny Rosen',
    address: {
      line1: '1234 Main Street',
      city: 'San Francisco',
      state: 'CA',
      postal_code: '94111',
      country: 'US',
    },
  },
})

# Set your secret key. Remember to switch to your live secret key in production!
# See your keys here: https://dashboard.stripe.com/account/apikeys
stripe.api_key = 'sk_test_4eC39HqLyjWDarjtT1zdp7dc'

cardholder = stripe.issuing.Cardholder.create(
  name='Jenny Rosen',
  email='jenny.rosen@example.com',
  phone_number='+18008675309',
  status='active',
  type='individual',
  billing={
    'name': 'Jenny Rosen',
    'address': {
      'line1': '1234 Main Street',
      'city': 'San Francisco',
      'state': 'CA',
      'postal_code': '94111',
      'country': 'US'
    }
  }
)

// Set your secret key. Remember to switch to your live secret key in production!
// See your keys here: https://dashboard.stripe.com/account/apikeys
\Stripe\Stripe::setApiKey('sk_test_4eC39HqLyjWDarjtT1zdp7dc');

$cardholder = \Stripe\Issuing\Cardholder::create([
  'name' => 'Jenny Rosen',
  'email' => 'jenny.rosen@example.com',
  'phone_number' => '+18008675309',
  'status' => 'active',
  'type' => 'individual',
  'billing' => [
    'name' => 'Jenny Rosen',
    'address' => [
      'line1' => '1234 Main Street',
      'city' => 'San Francisco',
      'state' => 'CA',
      'postal_code' => '94111',
      'country' => 'US',
    ],
  ],
]);

// Set your secret key. Remember to switch to your live secret key in production!
// See your keys here: https://dashboard.stripe.com/account/apikeys
Stripe.apiKey = "sk_test_4eC39HqLyjWDarjtT1zdp7dc";

Map<String, Object> addressParams = new HashMap<String, Object>();
addressParams.put("line1", "1234 Main Street");
addressParams.put("city", "San Francisco");
addressParams.put("state", "CA");
addressParams.put("postal_code", "94111");
addressParams.put("country", "US");

Map<String, Object> billingParams = new HashMap<String, Object>();
billingParams.put("name", "Jenny Rosen");
billingParams.put("address", addressParams);

Map<String, Object> cardholderParams = new HashMap<>();
cardholderParams.put("name", "Jenny Rosen");
cardholderParams.put("email", "jenny.rosen@example.com");
cardholderParams.put("phone_number", "+18008675309");
cardholderParams.put("status", "active");
cardholderParams.put("type", "individual");
cardholderParams.put("billing", billingParams);

Cardholder cardholder = Cardholder.create(cardholderParams);

// Set your secret key. Remember to switch to your live secret key in production!
// See your keys here: https://dashboard.stripe.com/account/apikeys
const stripe = require('stripe')('sk_test_4eC39HqLyjWDarjtT1zdp7dc');

const cardholder = await stripe.issuing.cardholders.create({
  name: 'Jenny Rosen',
  email: 'jenny.rosen@example.com',
  phone_number: '+18008675309',
  status: 'active',
  type: 'individual',
  billing: {
    name: 'Jenny Rosen',
    address: {
      line1: '1234 Main Street',
      city: 'San Francisco',
      state: 'CA',
      postal_code: '94111',
      country: 'US',
    },
  },
});

// Set your secret key. Remember to switch to your live secret key in production!
// See your keys here: https://dashboard.stripe.com/account/apikeys
stripe.Key = "sk_test_4eC39HqLyjWDarjtT1zdp7dc"

params := &stripe.IssuingCardholderParams{
  Billing: &stripe.IssuingBillingParams{
    Address: &stripe.AddressParams{
      Country:    stripe.String("US"),
      Line1:      stripe.String("1234 Main Street"),
      City:       stripe.String("San Francisco"),
      PostalCode: stripe.String("94111"),
      State:      stripe.String("CA"),
    },
    Name: stripe.String("Jenny Rosen"),
  },
  Email: stripe.String("jenny.rosen@example.com"),
  Name: stripe.String("Jenny Rosen"),
  PhoneNumber: stripe.String("+18008675309"),
  Status: stripe.String(string(stripe.IssuingCardholderStatusActive)),
  Type: stripe.String(string(stripe.IssuingCardholderTypeIndividual)),
}
crdholder, err := cardholder.New(params)

// Set your secret key. Remember to switch to your live secret key in production!
// See your keys here: https://dashboard.stripe.com/account/apikeys
StripeConfiguration.ApiKey = "sk_test_4eC39HqLyjWDarjtT1zdp7dc";

var options = new CardholderCreateOptions
{
    Billing = new BillingOptions
    {
        Name = "Jenny Rosen",
        Address = new AddressOptions
        {
          Line1 = "1234 Main Street",
          City = "San Francisco",
          State = "CA",
          PostalCode = "94111",
          Country = "US",
        },
    },
    Email = "jenny.rosen@example.com",
    PhoneNumber = "+18008675309",
    Name = "Jenny Rosen",
    Status = "active",
    Type = "individual",
};

var service = new CardholderService();
var cardholder = service.Create(options);

Step 3: Create a card

After creating a cardholder, you can create a card for them. Provide the id of the Cardholder object and currency. For immediate testing, create a virtual card and set its status to active.

curl https://api.stripe.com/v1/issuing/cards \
  -u sk_test_4eC39HqLyjWDarjtT1zdp7dc: \
  -d cardholder=ich_1Cm3pZIyNTgGDVfzI83rasFP \
  -d type=virtual \
  -d currency=usd \
  -d status=active

# Set your secret key. Remember to switch to your live secret key in production!
# See your keys here: https://dashboard.stripe.com/account/apikeys
Stripe.api_key = 'sk_test_4eC39HqLyjWDarjtT1zdp7dc'

card = Stripe::Issuing::Card.create({
  cardholder: 'ich_1Cm3pZIyNTgGDVfzI83rasFP',
  type: 'virtual',
  currency: 'usd',
  status: 'active',
})

# Set your secret key. Remember to switch to your live secret key in production!
# See your keys here: https://dashboard.stripe.com/account/apikeys
stripe.api_key = 'sk_test_4eC39HqLyjWDarjtT1zdp7dc'

card = stripe.issuing.Card.create(
  cardholder='ich_1Cm3pZIyNTgGDVfzI83rasFP',
  type='virtual',
  currency='usd',
  status='active'
)

// Set your secret key. Remember to switch to your live secret key in production!
// See your keys here: https://dashboard.stripe.com/account/apikeys
\Stripe\Stripe::setApiKey('sk_test_4eC39HqLyjWDarjtT1zdp7dc');

$card = \Stripe\Issuing\Card::create([
  'cardholder' => 'ich_1Cm3pZIyNTgGDVfzI83rasFP',
  'type' => 'virtual',
  'currency' => 'usd',
  'status' => 'active',
]);

// Set your secret key. Remember to switch to your live secret key in production!
// See your keys here: https://dashboard.stripe.com/account/apikeys
Stripe.apiKey = "sk_test_4eC39HqLyjWDarjtT1zdp7dc";

Map<String, Object> params = new HashMap<>();
params.put("cardholder", "ich_1Cm3pZIyNTgGDVfzI83rasFP");
params.put("type", "virtual");
params.put("currency", "usd");
params.put("status", "active");
Card card = Card.create(params);

// Set your secret key. Remember to switch to your live secret key in production!
// See your keys here: https://dashboard.stripe.com/account/apikeys
const stripe = require('stripe')('sk_test_4eC39HqLyjWDarjtT1zdp7dc');

const card = await stripe.issuing.cards.create({
  cardholder: 'ich_1Cm3pZIyNTgGDVfzI83rasFP',
  type: 'virtual',
  currency: 'usd',
  status: 'active',
});

// Set your secret key. Remember to switch to your live secret key in production!
// See your keys here: https://dashboard.stripe.com/account/apikeys
stripe.Key = "sk_test_4eC39HqLyjWDarjtT1zdp7dc"

params := &stripe.IssuingCardParams{
  Cardholder: stripe.String("ich_1Cm3pZIyNTgGDVfzI83rasFP"),
  Currency: stripe.String(string(stripe.CurrencyUSD)),
  Type: stripe.String(string(stripe.IssuingCardTypeVirtual)),
  Status: stripe.String(string(stripe.IssuingCardStatusInactive)),
}
crd, err := card.New(params)

// Set your secret key. Remember to switch to your live secret key in production!
// See your keys here: https://dashboard.stripe.com/account/apikeys
StripeConfiguration.ApiKey = "sk_test_4eC39HqLyjWDarjtT1zdp7dc";

var options = new CardCreateOptions
{
  Cardholder = "ich_1Cm3pZIyNTgGDVfzI83rasFP",
  Type = "virtual",
  Currency = "usd",
  Status = "active",
};

var service = new CardService();
var card = service.Create(options);

Step 4: Retrieve sensitive card details

For security reasons, API responses returning a card object will not include sensitive details like the full card number, expiry date, or CVC code by default. For virtual cards, you can retrieve these details when required.

curl https://api.stripe.com/v1/issuing/cards/ic_1Cm3paIyNTgGDVfzBqq1uqxR/details \
  -u sk_test_4eC39HqLyjWDarjtT1zdp7dc:

# Set your secret key. Remember to switch to your live secret key in production!
# See your keys here: https://dashboard.stripe.com/account/apikeys
Stripe.api_key = 'sk_test_4eC39HqLyjWDarjtT1zdp7dc'

card_details = Stripe::Issuing::Card.details('ic_1Cm3paIyNTgGDVfzBqq1uqxR')

# Set your secret key. Remember to switch to your live secret key in production!
# See your keys here: https://dashboard.stripe.com/account/apikeys
stripe.api_key = 'sk_test_4eC39HqLyjWDarjtT1zdp7dc'

card_details = stripe.issuing.Card.details('ic_1Cm3paIyNTgGDVfzBqq1uqxR')

// Set your secret key. Remember to switch to your live secret key in production!
// See your keys here: https://dashboard.stripe.com/account/apikeys
\Stripe\Stripe::setApiKey('sk_test_4eC39HqLyjWDarjtT1zdp7dc');

$card = \Stripe\Issuing\Card::retrieve('ic_1Cm3paIyNTgGDVfzBqq1uqxR');
$details = $card->details();

// Set your secret key. Remember to switch to your live secret key in production!
// See your keys here: https://dashboard.stripe.com/account/apikeys
Stripe.apiKey = "sk_test_4eC39HqLyjWDarjtT1zdp7dc";

Card card = Card.retrieve("ic_1Cm3paIyNTgGDVfzBqq1uqxR");

// Set your secret key. Remember to switch to your live secret key in production!
// See your keys here: https://dashboard.stripe.com/account/apikeys
const stripe = require('stripe')('sk_test_4eC39HqLyjWDarjtT1zdp7dc');

const details = await stripe.issuing.cards.retrieveDetails('ic_1CoYuRKEl2ztzE5GIEDjQiUI');

// Set your secret key. Remember to switch to your live secret key in production!
// See your keys here: https://dashboard.stripe.com/account/apikeys
stripe.Key = "sk_test_4eC39HqLyjWDarjtT1zdp7dc"

details, err := card.Details("ic_1CoYuRKEl2ztzE5GIEDjQiUI", nil)

// Set your secret key. Remember to switch to your live secret key in production!
// See your keys here: https://dashboard.stripe.com/account/apikeys
StripeConfiguration.ApiKey = "sk_test_4eC39HqLyjWDarjtT1zdp7dc";

var service = new CardService();
var details = service.Details("ic_1CoYuRKEl2ztzE5GIEDjQiUI");

Step 5: Create a source

Using the newly issued card’s details, create a source. A source will allow you to create a test charge as it simulates the swipe or entry of an issued card at the time of purchase. If you provide address details or a CVC, these will be compared to the values that you define when creating the card, and the results of this comparison will be provided

curl https://api.stripe.com/v1/sources \
  -u sk_test_4eC39HqLyjWDarjtT1zdp7dc: \
  -d type=card \
  -d "card[number]"=4000009990000006 \
  -d "card[exp_month]"=8 \
  -d "card[exp_year]"=2022

# Set your secret key. Remember to switch to your live secret key in production!
# See your keys here: https://dashboard.stripe.com/account/apikeys
Stripe.api_key = 'sk_test_4eC39HqLyjWDarjtT1zdp7dc'

source = Stripe::Source.create({
  type: 'card',
  card: {
    number: '4000009990000006',
    exp_month: 8,
    exp_year: 2022,
  },
})

# Set your secret key. Remember to switch to your live secret key in production!
# See your keys here: https://dashboard.stripe.com/account/apikeys
stripe.api_key = 'sk_test_4eC39HqLyjWDarjtT1zdp7dc'

source = stripe.Source.create(
  type='card',
  card={
    'number': '4000009990000006',
    'exp_month': 8,
    'exp_year': 2022,
  },
)

// Set your secret key. Remember to switch to your live secret key in production!
// See your keys here: https://dashboard.stripe.com/account/apikeys
\Stripe\Stripe::setApiKey('sk_test_4eC39HqLyjWDarjtT1zdp7dc');

$source = \Stripe\Source::create([
  'type' => 'card',
  'card' => [
    'number' => '4000009990000006',
    'exp_month' => 8,
    'exp_year' => 2022,
  ],
]);

// Set your secret key. Remember to switch to your live secret key in production!
// See your keys here: https://dashboard.stripe.com/account/apikeys
Stripe.apiKey = "sk_test_4eC39HqLyjWDarjtT1zdp7dc";

Map<String, Object> cardParams = new HashMap<String, Object>();
cardParams.put("number", "4000009990000006");
cardParams.put("exp_month", 8)
cardParams.put("exp_year", 2022)

Map<String, Object> params = new HashMap<>();
params.put("type", "card");
params.put("card", cardParams);

Source source = Source.create(params);

// Set your secret key. Remember to switch to your live secret key in production!
// See your keys here: https://dashboard.stripe.com/account/apikeys
const stripe = require('stripe')('sk_test_4eC39HqLyjWDarjtT1zdp7dc');

const source = await stripe.sources.create({
  type: 'card',
  card: {
    number: '4000009990000006',
    exp_month: 8,
    exp_year: 2022,
  },
});

// Set your secret key. Remember to switch to your live secret key in production!
// See your keys here: https://dashboard.stripe.com/account/apikeys
stripe.Key = "sk_test_4eC39HqLyjWDarjtT1zdp7dc"

params := &stripe.SourceObjectParams{
  Type: stripe.String("card"),
  Currency: stripe.String(string(stripe.CurrencyUSD)),
  Card: &stripe.SourceOwnerParams{
    Number: stripe.String("4000009990000006"),
    ExpMonth: stripe.String("8"),
    ExpYear: stripe.String("2022"),
  },
}
s, err := source.New(params)

// Set your secret key. Remember to switch to your live secret key in production!
// See your keys here: https://dashboard.stripe.com/account/apikeys
StripeConfiguration.ApiKey = "sk_test_4eC39HqLyjWDarjtT1zdp7dc";

var options = new SourceCreateOptions
{
  Type = SourceType.Card,
  Currency = "usd",
  Card = new CreditCardOptions
  {
    Number = "4000009990000006",
    ExpMonth = 8,
    ExpYear = 2022,
  },
};

var service = new SourceService();
var source = service.Create(options);

Step 6: Create an uncaptured charge

Using auth and capture, create a charge that is not immediately captured.

curl https://api.stripe.com/v1/charges \
  -u sk_test_4eC39HqLyjWDarjtT1zdp7dc: \
  -d source=src_1Cn6EvIyNTgGDVfzosvqD8ld \
  -d amount=2000 \
  -d currency=usd \
  -d capture=false

# Set your secret key. Remember to switch to your live secret key in production!
# See your keys here: https://dashboard.stripe.com/account/apikeys
Stripe.api_key = 'sk_test_4eC39HqLyjWDarjtT1zdp7dc'

charge = Stripe::Charge.create({
  source: 'src_1Cn6EvIyNTgGDVfzosvqD8ld',
  amount: 2000,
  currency: 'usd',
  capture: false,
})

# Set your secret key. Remember to switch to your live secret key in production!
# See your keys here: https://dashboard.stripe.com/account/apikeys
stripe.api_key = 'sk_test_4eC39HqLyjWDarjtT1zdp7dc'

charge = stripe.Charge.create(
  source='src_1Cn6EvIyNTgGDVfzosvqD8ld',
  amount=2000,
  currency='usd',
  capture=False,
)

// Set your secret key. Remember to switch to your live secret key in production!
// See your keys here: https://dashboard.stripe.com/account/apikeys
\Stripe\Stripe::setApiKey('sk_test_4eC39HqLyjWDarjtT1zdp7dc');

$charge = \Stripe\Charge::create([
  'source' => 'src_1Cn6EvIyNTgGDVfzosvqD8ld',
  'amount' => 2000,
  'currency' => 'usd',
  'capture' => false,
]);

// Set your secret key. Remember to switch to your live secret key in production!
// See your keys here: https://dashboard.stripe.com/account/apikeys
Stripe.apiKey = "sk_test_4eC39HqLyjWDarjtT1zdp7dc";

Map<String, Object> params = new HashMap<>();
params.put("source", "src_1Cn6EvIyNTgGDVfzosvqD8ld");
params.put("amount", 2000);
params.put("currency", "usd");
params.put("capture", false);
Charge charge = Charge.create(params);

// Set your secret key. Remember to switch to your live secret key in production!
// See your keys here: https://dashboard.stripe.com/account/apikeys
const stripe = require('stripe')('sk_test_4eC39HqLyjWDarjtT1zdp7dc');

const charge = await stripe.charges.create({
  source: 'src_1Cn6EvIyNTgGDVfzosvqD8ld',
  amount: 2000,
  currency: 'usd',
  capture: false,
});

// Set your secret key. Remember to switch to your live secret key in production!
// See your keys here: https://dashboard.stripe.com/account/apikeys
stripe.Key = "sk_test_4eC39HqLyjWDarjtT1zdp7dc"

params := &stripe.ChargeParams{
  Amount: 2000,
  Currency: "usd",
  Capture: false,
}
params.SetSource("src_1Cn6EvIyNTgGDVfzosvqD8ld")
ch, _ := charge.New(params)

// Set your secret key. Remember to switch to your live secret key in production!
// See your keys here: https://dashboard.stripe.com/account/apikeys
StripeConfiguration.ApiKey = "sk_test_4eC39HqLyjWDarjtT1zdp7dc";

var options = new ChargeCreateOptions
{
  Source = "src_1Cn6EvIyNTgGDVfzosvqD8ld",
  Amount = 2000,
  Currency = "usd",
  Capture = false,
};
var service = new ChargeService();
var charge = service.Create(options);

This step results in an authorization request. If there are authorization controls on the card, they are applied. If your integration is configured to receive and handle authorization requests, Stripe also sends the issuing_authorization.request event to your test authorization endpoint.

You can test international purchases by creating a charge in a currency that’s different from the card’s own currency (e.g., create a gbp charge for a usd card).

Handling authorizations

You can test how your integration handles changes to authorizations by replicating the possible actions that can occur.

Capturing an authorization (uncaptured charge)

To settle an uncaptured charge, which results in the creation of a Transaction object, capture the charge.

curl https://api.stripe.com/v1/charges/ch_1CmMk3IyNTgGDVfzqgWGCQr5/capture \
  -u sk_test_4eC39HqLyjWDarjtT1zdp7dc: \
  -X POST

# Set your secret key. Remember to switch to your live secret key in production!
# See your keys here: https://dashboard.stripe.com/account/apikeys
Stripe.api_key = 'sk_test_4eC39HqLyjWDarjtT1zdp7dc'

charge = Stripe::Charge.capture('ch_1CmMk3IyNTgGDVfzqgWGCQr5')

# Set your secret key. Remember to switch to your live secret key in production!
# See your keys here: https://dashboard.stripe.com/account/apikeys
stripe.api_key = 'sk_test_4eC39HqLyjWDarjtT1zdp7dc'

charge = stripe.Charge.capture('ch_1CmMk3IyNTgGDVfzqgWGCQr5')

// Set your secret key. Remember to switch to your live secret key in production!
// See your keys here: https://dashboard.stripe.com/account/apikeys
\Stripe\Stripe::setApiKey('sk_test_4eC39HqLyjWDarjtT1zdp7dc');

$charge = \Stripe\Charge::retrieve('ch_1CmMk3IyNTgGDVfzqgWGCQr5');
$charge.capture();

// Set your secret key. Remember to switch to your live secret key in production!
// See your keys here: https://dashboard.stripe.com/account/apikeys
Stripe.apiKey = "sk_test_4eC39HqLyjWDarjtT1zdp7dc";

Charge charge = Charge.retrieve("ch_1CmMk3IyNTgGDVfzqgWGCQr5");
charge.capture();

// Set your secret key. Remember to switch to your live secret key in production!
// See your keys here: https://dashboard.stripe.com/account/apikeys
const stripe = require('stripe')('sk_test_4eC39HqLyjWDarjtT1zdp7dc');

const charge = await stripe.charges.capture('ch_1CmMk3IyNTgGDVfzqgWGCQr5');

// Set your secret key. Remember to switch to your live secret key in production!
// See your keys here: https://dashboard.stripe.com/account/apikeys
stripe.Key = "sk_test_4eC39HqLyjWDarjtT1zdp7dc"

ch, _ := charge.Capture("ch_1CmMk3IyNTgGDVfzqgWGCQr5")

// Set your secret key. Remember to switch to your live secret key in production!
// See your keys here: https://dashboard.stripe.com/account/apikeys
StripeConfiguration.ApiKey = "sk_test_4eC39HqLyjWDarjtT1zdp7dc";

var service = new ChargeService();
var charge = service.Capture("ch_1CmMk3IyNTgGDVfzqgWGCQr5");

Partial capture

An authorization can be captured for any amount below what has been authorized. You can partially capture a test charge by providing a value for amount when capturing a charge.

Partially capturing a charge creates a Transaction object for the amount captured, and a reversal of the remaining amount. This reversal is represented as an update to the Authorization object.

Reversing an authorization

You can reverse (void) an authorization that has not been captured by creating a refund for the uncaptured charge.

curl https://api.stripe.com/v1/refunds \
  -u sk_test_4eC39HqLyjWDarjtT1zdp7dc: \
  -d charge=ch_1CmMk3IyNTgGDVfzqgWGCQr5

# Set your secret key. Remember to switch to your live secret key in production!
# See your keys here: https://dashboard.stripe.com/account/apikeys
Stripe.api_key = 'sk_test_4eC39HqLyjWDarjtT1zdp7dc'

refund = Stripe::Refund.create({
  charge: 'ch_1CmMk3IyNTgGDVfzqgWGCQr5',
})

# Set your secret key. Remember to switch to your live secret key in production!
# See your keys here: https://dashboard.stripe.com/account/apikeys
stripe.api_key = 'sk_test_4eC39HqLyjWDarjtT1zdp7dc'

refund = stripe.Refund.create(
  charge='ch_1CmMk3IyNTgGDVfzqgWGCQr5'
)

// Set your secret key. Remember to switch to your live secret key in production!
// See your keys here: https://dashboard.stripe.com/account/apikeys
\Stripe\Stripe::setApiKey('sk_test_4eC39HqLyjWDarjtT1zdp7dc');

$refund = \Stripe\Refund::create([
  'charge' => 'ch_1CmMk3IyNTgGDVfzqgWGCQr5',
]);

// Set your secret key. Remember to switch to your live secret key in production!
// See your keys here: https://dashboard.stripe.com/account/apikeys
Stripe.apiKey = "sk_test_4eC39HqLyjWDarjtT1zdp7dc";

Map<String, Object> params = new HashMap<>();
params.put("charge", "ch_1CmMk3IyNTgGDVfzqgWGCQr5");
Refund refund = Refund.create(params);

// Set your secret key. Remember to switch to your live secret key in production!
// See your keys here: https://dashboard.stripe.com/account/apikeys
const stripe = require('stripe')('sk_test_4eC39HqLyjWDarjtT1zdp7dc');

const refund = await stripe.refunds.create({
  charge: 'ch_1CmMk3IyNTgGDVfzqgWGCQr5',
});

// Set your secret key. Remember to switch to your live secret key in production!
// See your keys here: https://dashboard.stripe.com/account/apikeys
stripe.Key = "sk_test_4eC39HqLyjWDarjtT1zdp7dc"

params := &stripe.RefundParams{
  Charge: "ch_1CmMk3IyNTgGDVfzqgWGCQr5",
}
ref, _ := refund.New(params)

// Set your secret key. Remember to switch to your live secret key in production!
// See your keys here: https://dashboard.stripe.com/account/apikeys
StripeConfiguration.ApiKey = "sk_test_4eC39HqLyjWDarjtT1zdp7dc";

var options = new RefundCreateOptions
{
    Charge = "ch_1CmMk3IyNTgGDVfzqgWGCQr5",
};
var service = new RefundService();
var refund = service.Create(options);

Refunding a captured charge

Refunding a captured charge uses the same method as refunding an uncaptured one. A Transaction object of type refund is created that references the original authorization.

curl https://api.stripe.com/v1/refunds \
  -u sk_test_4eC39HqLyjWDarjtT1zdp7dc: \
  -d charge=ch_1CmMk3IyNTgGDVfzqgWGCQr5 \
  -d amount=2000

# Set your secret key. Remember to switch to your live secret key in production!
# See your keys here: https://dashboard.stripe.com/account/apikeys
Stripe.api_key = 'sk_test_4eC39HqLyjWDarjtT1zdp7dc'

refund = Stripe::Refund.create({
  charge: 'ch_1CmMk3IyNTgGDVfzqgWGCQr5',
  amount: 2000,
})

# Set your secret key. Remember to switch to your live secret key in production!
# See your keys here: https://dashboard.stripe.com/account/apikeys
stripe.api_key = 'sk_test_4eC39HqLyjWDarjtT1zdp7dc'

refund = stripe.Refund.create(
  charge='ch_1CmMk3IyNTgGDVfzqgWGCQr5',
  amount=2000,
)

// Set your secret key. Remember to switch to your live secret key in production!
// See your keys here: https://dashboard.stripe.com/account/apikeys
\Stripe\Stripe::setApiKey('sk_test_4eC39HqLyjWDarjtT1zdp7dc');

$refund = \Stripe\Refund::create([
  'charge' => 'ch_1CmMk3IyNTgGDVfzqgWGCQr5',
  'amount' => 2000,
]);

// Set your secret key. Remember to switch to your live secret key in production!
// See your keys here: https://dashboard.stripe.com/account/apikeys
Stripe.apiKey = "sk_test_4eC39HqLyjWDarjtT1zdp7dc";

Map<String, Object> params = new HashMap<>();
params.put("charge", "ch_1CmMk3IyNTgGDVfzqgWGCQr5");
params.put("amount", 2000);
Refund refund = Refund.create(params);

// Set your secret key. Remember to switch to your live secret key in production!
// See your keys here: https://dashboard.stripe.com/account/apikeys
const stripe = require('stripe')('sk_test_4eC39HqLyjWDarjtT1zdp7dc');

const refund = await stripe.refunds.create({
  charge: 'ch_1CmMk3IyNTgGDVfzqgWGCQr5',
  amount: 2000,
});

// Set your secret key. Remember to switch to your live secret key in production!
// See your keys here: https://dashboard.stripe.com/account/apikeys
stripe.Key = "sk_test_4eC39HqLyjWDarjtT1zdp7dc"

params := &stripe.RefundParams{
  Charge: "ch_1CmMk3IyNTgGDVfzqgWGCQr5",
  Amount: 2000,
}
ref, _ := refund.New(params)

// Set your secret key. Remember to switch to your live secret key in production!
// See your keys here: https://dashboard.stripe.com/account/apikeys
StripeConfiguration.ApiKey = "sk_test_4eC39HqLyjWDarjtT1zdp7dc";

var options = new RefundCreateOptions
{
  Charge = "ch_1CmMk3IyNTgGDVfzqgWGCQr5",
  Amount = 2000,
};
var service = new RefundService();
var refund = service.Create(options);

Testing verification outcomes

Issued cards support AVS and CVC checks. You can simulate authorizations that either provide the wrong information so these checks fail, or no information so the checks cannot be run. The results of these checks are represented on Authorization objects as values for verification_data.

AVS and CVC check

When creating a Source object for an issued card, providing address and CVC information is optional. If they are not provided, the resulting ZIP code, street address, and CVC checks return not_provided. To test AVS and CVC checks, provide an address, a CVC, or both during Source creation.

curl https://api.stripe.com/v1/sources \
  -u sk_test_4eC39HqLyjWDarjtT1zdp7dc: \
  -d type=card \
  -d "card[number]"=4000009990000006 \
  -d "card[exp_month]"=8 \
  -d "card[exp_year]"=2022 \
  -d "card[cvc]"=123 \
  -d "owner[address][line1]"="1234 Main Street" \
  -d "owner[address][city]"="San Francisco" \
  -d "owner[address][state]"=CA \
  -d "owner[address][postal_code]"=94111 \
  -d "owner[address][country]"=US

# Set your secret key. Remember to switch to your live secret key in production!
# See your keys here: https://dashboard.stripe.com/account/apikeys
Stripe.api_key = 'sk_test_4eC39HqLyjWDarjtT1zdp7dc'

source = Stripe::Source.create({
  card: {
    number: '4000009990000006',
    exp_month: 8,
    exp_year: 2022,
    cvc: 123,
  },
  type: 'card',
  owner: {
    address: {
      line1: '1234 Main Street',
      city: 'San Francisco',
      state: 'CA',
      postal_code: '94111',
      country: 'US',
    },
  },
})

# Set your secret key. Remember to switch to your live secret key in production!
# See your keys here: https://dashboard.stripe.com/account/apikeys
stripe.api_key = 'sk_test_4eC39HqLyjWDarjtT1zdp7dc'

source = stripe.Source.create(
  type='card',
  card={
    'number': '4000009990000006',
    'exp_month': 8,
    'exp_year': 2022,
    'cvc': 123,
  },
  owner={
    'address': {
      'line1': '1234 Main Street',
      'city': 'San Francisco',
      'state': 'CA',
      'postal_code': '94111',
      'country': 'US',
    },
  },
)

// Set your secret key. Remember to switch to your live secret key in production!
// See your keys here: https://dashboard.stripe.com/account/apikeys
\Stripe\Stripe::setApiKey('sk_test_4eC39HqLyjWDarjtT1zdp7dc');

$source = \Stripe\Source::create([
  'type' => 'card',
  'card' => [
    'number' => '4000009990000006',
    'exp_month' => 8,
    'exp_year' => 2022,
    'cvc' => 123,
  ],
  'owner' => [
    'address' => [
      'line1' => '1234 Main Street',
      'city' => 'San Francisco',
      'state' => 'CA',
      'postal_code' => '94111',
      'country' => 'US',
    ],
  ],
]);

// Set your secret key. Remember to switch to your live secret key in production!
// See your keys here: https://dashboard.stripe.com/account/apikeys
Stripe.apiKey = "sk_test_4eC39HqLyjWDarjtT1zdp7dc";

Map<String, Object> addressParams = new HashMap<String, Object>();
addressParams.put("line1", "1234 Main Street");
addressParams.put("city", "San Francisco");
addressParams.put("state", "CA");
addressParams.put("postal_code", "94111");
addressParams.put("country", "US");

Map<String, Object> ownerParams = new HashMap<String, Object>();
ownerParams.put("address", addressParams);

Map<String, Object> cardParams = new HashMap<String, Object>();
cardParams.put("number", "4000009990000006");
cardParams.put("exp_month", 8)
cardParams.put("exp_year", 2022)
cardParams.put("cvc", 123)

Map<String, Object> params = new HashMap<>();
params.put("type", "card");
params.put("card", cardParams);
params.put("owner", ownerParams);
Source source = Source.create(params);

// Set your secret key. Remember to switch to your live secret key in production!
// See your keys here: https://dashboard.stripe.com/account/apikeys
const stripe = require('stripe')('sk_test_4eC39HqLyjWDarjtT1zdp7dc');

const source = await stripe.sources.create({
  type: 'card',
  card: {
    number: '4000009990000006',
    exp_month: 8,
    exp_year: 2022,
    cvc: 123,
  },
  owner: {
    address: {
      line1: '1234 Main Street',
      city: 'San Francisco',
      state: 'CA',
      postal_code: '94111',
      country: 'US',
    },
  },
});

// Set your secret key. Remember to switch to your live secret key in production!
// See your keys here: https://dashboard.stripe.com/account/apikeys
stripe.Key = "sk_test_4eC39HqLyjWDarjtT1zdp7dc"

params := &stripe.SourceParams{
  Type: "card",
  Card: &stripe.SourceOwnerParams{
    Number: stripe.String("4000009990000006"),
    ExpMonth: stripe.String("8"),
    ExpYear: stripe.String("2022"),
    Cvc: stripe.String("123"),
  },
  Owner: &stripe.IssuingOwnerParams{
    Address: &stripe.AddressParams{
      Country:    stripe.String("US"),
      Line1:      stripe.String("1234 Main Street"),
      City:       stripe.String("San Francisco"),
      PostalCode: stripe.String("94111"),
      State:      stripe.String("CA"),
    },
  },
}
sou, _ := source.New(params)

// Set your secret key. Remember to switch to your live secret key in production!
// See your keys here: https://dashboard.stripe.com/account/apikeys
StripeConfiguration.ApiKey = "sk_test_4eC39HqLyjWDarjtT1zdp7dc";

var options = new SourceCreateOptions
{
  Card = new CreditCardOptions
  {
    Number = "4000009990000006",
    ExpMonth = 8,
    ExpYear = 2022,
    Cvc = "123",
  },
  Type = "card",
  Owner = new SourceOwnerOptions
  {
    Address = new AddressOptions
    {
      City = "San Francisco",
      Country = "US",
      Line1 = "1234 Main Street",
      PostalCode = "94111",
      State = "CA",
    },
  },
};
var service = new SourceService();
var source = service.Create(options);

Providing the same address as the billing address on the card results in a successful AVS check (the respective verification_data fields return match), as well as providing the correct CVC (the value returned in the card details) for the CVC check.

To test for a failed check, create a source that has a different ZIP code, street address, and CVC—this results in verification_data returning mismatch.

English

Deutsch

English

Español (España)

Français

Italiano

日本語

简体中文

Sign In →