Update a card
POST / v1 / accounts /:id / external_accounts /:id
If you need to update only some card details, like the billing address or expiration date, you can do so without having to re-enter the full card details. Stripe also works directly with card networks so that your customers can continue using your service without interruption.
Parameters
- default _ for _ currency boolean When set to true, this becomes the default external account for its currency.
- metadata map Set of key-value pairs that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to
metadata.
More parameters
- address _ city string
- address _ country string
- address _ line1 string
- address _ line2 string
- address _ state string
- address _ zip string
- exp _ month string
- exp _ year string
- name string
Returns
Returns the card object.
Response
{ "id": "card_1NBLeN2eZvKYlo2CIq1o7Pzs", "object": "card", "address_city": null, "address_country": null, "address_line1": null, "address_line1_check": null, "address_line2": null, "address_state": null, "address_zip": null, "address_zip_check": null, "brand": "Visa", "country": "US", "cvc_check": "pass", "dynamic_last4": null, "exp_month": 8, "exp_year": 2024, "fingerprint": "Xt5EWLLDS7FJjR1c", "funding": "credit", "last4": "4242", "metadata": { "order_id": "6735" }, "name": "Jenny Rosen", "redaction": null, "tokenization_method": null, "wallet": null, "account": "acct_1032D82eZvKYlo2C"}
Retrieve a card
GET / v1 / accounts /:id / external_accounts /:id
By default, you can see the 10 most recent external accounts stored on a connected account directly on the object. You can also retrieve details about a specific card stored on the account.
Parameters
- id string Required Unique identifier for the external account to be retrieved.
Returns
Returns the card object.
Response
{ "id": "card_1NAinb2eZvKYlo2C1Fm9mZsu", "object": "card", "address_city": null, "address_country": null, "address_line1": null, "address_line1_check": null, "address_line2": null, "address_state": null, "address_zip": null, "address_zip_check": null, "brand": "Visa", "country": "US", "cvc_check": "pass", "dynamic_last4": null, "exp_month": 8, "exp_year": 2024, "fingerprint": "Xt5EWLLDS7FJjR1c", "funding": "credit", "last4": "4242", "metadata": {}, "name": null, "redaction": null, "tokenization_method": null, "wallet": null, "account": "acct_1032D82eZvKYlo2C"}
List all cards
GET / v1 / accounts /:id / external_accounts
You can see a list of the cards that belong to a connected account. The 10 most recent external accounts are available on the account object. If you need more than 10, you can use this API method and the limit and starting_after parameters to page through additional cards.
Parameters
No parameters.
More parameters
- ending _ before string
- limit integer
- object string
- starting _ after string
Returns
Returns a list of the cards stored on the account.
Response