Create a card

Changed on Sep 29, 2026

When you create a new credit card, you must specify a customer or recipient on which to create it.

If the card’s owner has no default card, then the new card will become the default. However, if the owner already has a default, then it will not change. To change the default, you should update the customer to have a new default_source.

post/v1/customers/{customer}/cards

Request

Base URL: https://api.stripe.com
URL: https://api.stripe.com/v1/customers/{customer}/cards
Auth: one of:
- HTTP basic
- HTTP bearer

Path parameters

customerstring required

Response

Successful response.

Changes

Sep 29, 20267cff4cc46d06 Revision changes
- warning
  added the new final_payment_failure enum value to the ///////////// response property for the response status
- warning
  added the new final_payment_failure enum value to the ///////// response property for the response status
- warning
  added the new first_payment_failure enum value to the ///////////// response property for the response status
- warning
  added the new first_payment_failure enum value to the ///////// response property for the response status
Jul 1, 2026e24a26de4188 Revision changes
- breaking
  removed the required property //////////////////////////// from the response with the status
- breaking
  removed the required property ////////////////////////// from the response with the status
- breaking
  removed the required property ////////////////////////// from the response with the status
- breaking
  removed the required property /////////////////////// from the response with the status
- breaking
  removed the required property ///////////////////// from the response with the status
- breaking
  removed the required property ///////////////////// from the response with the status
- breaking
  removed the required property //////////////////////////// from the response with the status
- breaking
  removed the required property ////////////////////////// from the response with the status
- breaking
  removed the required property ////////////////////////// from the response with the status
- breaking
  removed the required property ////////////////////////////// from the response with the status
- breaking
  removed the required property //////////////////////////// from the response with the status
- breaking
  removed the required property //////////////////////////// from the response with the status
- breaking
  removed the required property ///////////////////////// from the response with the status
- breaking
  removed the required property /////////////////////// from the response with the status
- breaking
  removed the required property /////////////////////// from the response with the status
- breaking
  removed the required property ////////////////////////////// from the response with the status
- breaking
  removed the required property //////////////////////////// from the response with the status
- breaking
  removed the required property //////////////////////////// from the response with the status
- breaking
  removed the required property //////////////////////////////// from the response with the status
- breaking
  removed the required property ////////////////////////////// from the response with the status
- breaking
  removed the required property ////////////////////////////// from the response with the status
- breaking
  removed the required property /////////////////////////// from the response with the status
- breaking
  removed the required property ///////////////////////// from the response with the status
- breaking
  removed the required property ///////////////////////// from the response with the status
- breaking
  removed the required property //////////////////////////////// from the response with the status
- breaking
  removed the required property ////////////////////////////// from the response with the status
- breaking
  removed the required property ////////////////////////////// from the response with the status
- breaking
  removed the required property ///////////////////////// from the response with the status
- breaking
  removed the required property /////////////////////// from the response with the status
- breaking
  removed the required property /////////////////////// from the response with the status
- breaking
  removed the required property ////////////////////////// from the response with the status
- breaking
  removed the required property //////////////////////// from the response with the status
- breaking
  removed the required property //////////////////////// from the response with the status
- breaking
  removed the required property //////////////////////////// from the response with the status
- breaking
  removed the required property ////////////////////////// from the response with the status
- breaking
  removed the required property ////////////////////////// from the response with the status
- breaking
  removed the required property ///////////////////////////////////////// from the response with the status
- breaking
  removed the required property /////////////////////////////////////// from the response with the status
- breaking
  removed the required property /////////////////////////////////////// from the response with the status
- breaking
  removed the required property //////////////////////////////////// from the response with the status
- breaking
  removed the required property ////////////////////////////////// from the response with the status
- breaking
  removed the required property ////////////////////////////////// from the response with the status
- breaking
  removed the required property ///////////////////////////////////////// from the response with the status
- breaking
  removed the required property /////////////////////////////////////// from the response with the status
- breaking
  removed the required property /////////////////////////////////////// from the response with the status
- breaking
  removed the required property ///////////////////////////////////////// from the response with the status
- breaking
  removed the required property /////////////////////////////////////// from the response with the status
- breaking
  removed the required property /////////////////////////////////////// from the response with the status
- breaking
  removed the required property //////////////////////////////////// from the response with the status
- breaking
  removed the required property ////////////////////////////////// from the response with the status
- breaking
  removed the required property ////////////////////////////////// from the response with the status
- breaking
  removed the required property ///////////////////////////////////////// from the response with the status
- breaking
  removed the required property /////////////////////////////////////// from the response with the status
- breaking
  removed the required property /////////////////////////////////////// from the response with the status
- breaking
  removed the required property ///////////////////////////////////////// from the response with the status
- breaking
  removed the required property /////////////////////////////////////// from the response with the status
- breaking
  removed the required property /////////////////////////////////////// from the response with the status
- breaking
  removed the required property //////////////////////////////////// from the response with the status
- breaking
  removed the required property ////////////////////////////////// from the response with the status
- breaking
  removed the required property ////////////////////////////////// from the response with the status
- breaking
  removed the required property ///////////////////////////////////////// from the response with the status
- breaking
  removed the required property /////////////////////////////////////// from the response with the status
- breaking
  removed the required property /////////////////////////////////////// from the response with the status
- breaking
  removed the required property ///////////////////////////////// from the response with the status
- breaking
  removed the required property /////////////////////////////// from the response with the status
- breaking
  removed the required property /////////////////////////////// from the response with the status
- breaking
  removed the required property //////////////////////////// from the response with the status
- breaking
  removed the required property ////////////////////////// from the response with the status
- breaking
  removed the required property ////////////////////////// from the response with the status
- breaking
  removed the required property ///////////////////////////////// from the response with the status
- breaking
  removed the required property /////////////////////////////// from the response with the status
- breaking
  removed the required property /////////////////////////////// from the response with the status
- breaking
  removed the required property ////////////////////////////////// from the response with the status
- breaking
  removed the required property //////////////////////////////// from the response with the status
- breaking
  removed the required property //////////////////////////////// from the response with the status
- breaking
  removed the required property ///////////////////////////// from the response with the status
- breaking
  removed the required property /////////////////////////// from the response with the status
- breaking
  removed the required property /////////////////////////// from the response with the status
- breaking
  removed the required property ////////////////////////////////// from the response with the status
- breaking
  removed the required property //////////////////////////////// from the response with the status
- breaking
  removed the required property //////////////////////////////// from the response with the status
- breaking
  removed the required property //////////////////////// from the response with the status
- breaking
  removed the required property ////////////////////// from the response with the status
- breaking
  removed the required property ////////////////////// from the response with the status
- breaking
  removed the required property /////////////////// from the response with the status
- breaking
  removed the required property ///////////////// from the response with the status
- breaking
  removed the required property ///////////////// from the response with the status
- breaking
  removed the required property //////////////////////// from the response with the status
- breaking
  removed the required property ////////////////////// from the response with the status
- breaking
  removed the required property ////////////////////// from the response with the status
- breaking
  removed the required property ////////////////////////// from the response with the status
- breaking
  removed the required property //////////////////////// from the response with the status
- breaking
  removed the required property //////////////////////// from the response with the status
- breaking
  removed the required property ///////////////////// from the response with the status
- breaking
  removed the required property /////////////////// from the response with the status
- breaking
  removed the required property /////////////////// from the response with the status
- breaking
  removed the required property ////////////////////////// from the response with the status
- breaking
  removed the required property //////////////////////// from the response with the status
- breaking
  removed the required property //////////////////////// from the response with the status
- breaking
  removed the required property //////////////////////////// from the response with the status
- breaking
  removed the required property ////////////////////////// from the response with the status
- breaking
  removed the required property ////////////////////////// from the response with the status
- breaking
  removed the required property /////////////////////// from the response with the status
- breaking
  removed the required property ///////////////////// from the response with the status
- breaking
  removed the required property ///////////////////// from the response with the status
- breaking
  removed the required property //////////////////////////// from the response with the status
- breaking
  removed the required property ////////////////////////// from the response with the status
- breaking
  removed the required property ////////////////////////// from the response with the status
- breaking
  removed the required property ///////////////////// from the response with the status
- breaking
  removed the required property /////////////////// from the response with the status
- breaking
  removed the required property /////////////////// from the response with the status
- breaking
  removed the required property ////////////////////// from the response with the status
- breaking
  removed the required property //////////////////// from the response with the status
- breaking
  removed the required property //////////////////// from the response with the status
- breaking
  removed the required property //////////////////////// from the response with the status
- breaking
  removed the required property ////////////////////// from the response with the status
- breaking
  removed the required property ////////////////////// from the response with the status
- breaking
  removed the required property ///////////////////////////////////// from the response with the status
- breaking
  removed the required property /////////////////////////////////// from the response with the status
- breaking
  removed the required property /////////////////////////////////// from the response with the status
- breaking
  removed the required property //////////////////////////////// from the response with the status
- breaking
  removed the required property ////////////////////////////// from the response with the status
- breaking
  removed the required property ////////////////////////////// from the response with the status
- breaking
  removed the required property ///////////////////////////////////// from the response with the status
- breaking
  removed the required property /////////////////////////////////// from the response with the status
- breaking
  removed the required property /////////////////////////////////// from the response with the status
- breaking
  removed the required property ///////////////////////////////////// from the response with the status
- breaking
  removed the required property /////////////////////////////////// from the response with the status
- breaking
  removed the required property /////////////////////////////////// from the response with the status
- breaking
  removed the required property //////////////////////////////// from the response with the status
- breaking
  removed the required property ////////////////////////////// from the response with the status
- breaking
  removed the required property ////////////////////////////// from the response with the status
- breaking
  removed the required property ///////////////////////////////////// from the response with the status
- breaking
  removed the required property /////////////////////////////////// from the response with the status
- breaking
  removed the required property /////////////////////////////////// from the response with the status
- breaking
  removed the required property ///////////////////////////////////// from the response with the status
- breaking
  removed the required property /////////////////////////////////// from the response with the status
- breaking
  removed the required property /////////////////////////////////// from the response with the status
- breaking
  removed the required property //////////////////////////////// from the response with the status
- breaking
  removed the required property ////////////////////////////// from the response with the status
- breaking
  removed the required property ////////////////////////////// from the response with the status
- breaking
  removed the required property ///////////////////////////////////// from the response with the status
- breaking
  removed the required property /////////////////////////////////// from the response with the status
- breaking
  removed the required property /////////////////////////////////// from the response with the status
- breaking
  removed the required property ///////////////////////////// from the response with the status
- breaking
  removed the required property /////////////////////////// from the response with the status
- breaking
  removed the required property /////////////////////////// from the response with the status
- breaking
  removed the required property //////////////////////// from the response with the status
- breaking
  removed the required property ////////////////////// from the response with the status
- breaking
  removed the required property ////////////////////// from the response with the status
- breaking
  removed the required property ///////////////////////////// from the response with the status
- breaking
  removed the required property /////////////////////////// from the response with the status
- breaking
  removed the required property /////////////////////////// from the response with the status
- breaking
  removed the required property ////////////////////////////// from the response with the status
- breaking
  removed the required property //////////////////////////// from the response with the status
- breaking
  removed the required property //////////////////////////// from the response with the status
- breaking
  removed the required property ///////////////////////// from the response with the status
- breaking
  removed the required property /////////////////////// from the response with the status
- breaking
  removed the required property /////////////////////// from the response with the status
- breaking
  removed the required property ////////////////////////////// from the response with the status
- breaking
  removed the required property //////////////////////////// from the response with the status
- breaking
  removed the required property //////////////////////////// from the response with the status
- breaking
  removed the required property //////////// from the response with the status
- breaking
  removed the required property ////////// from the response with the status
- breaking
  removed the required property ////////// from the response with the status
This list may be incomplete.

Some revisions have not been checked yet.

Operation history (4 revisions)