POST /v1/issuing/cardholders/{cardholder}
Updates the specified Issuing Cardholder object by setting the values of the parameters passed. Any parameters not provided will be left unchanged.
Servers
- https://api.stripe.com/
Path parameters
| Name | Type | Required | Description |
|---|---|---|---|
cardholder |
String | Yes |
Request headers
| Name | Type | Required | Description |
|---|---|---|---|
Content-Type |
String | Yes |
The media type of the request body.
Default value: "application/x-www-form-urlencoded" |
Request body fields
| Name | Type | Required | Description |
|---|---|---|---|
spending_controls |
Object | No |
Rules that control spending across this cardholder's cards. Refer to our documentation for more details. |
spending_controls.blocked_merchant_countries[] |
Array | No | |
spending_controls.spending_limits[] |
Array | No | |
spending_controls.spending_limits[].interval |
String | Yes |
Possible values:
|
spending_controls.spending_limits[].categories[] |
Array | No | |
spending_controls.spending_limits[].amount |
Integer | Yes | |
spending_controls.spending_limits_currency |
String | No | |
spending_controls.allowed_merchant_countries[] |
Array | No | |
spending_controls.allowed_categories[] |
Array | No | |
spending_controls.blocked_categories[] |
Array | No | |
email |
String | No |
The cardholder's email address. |
individual |
Object | No |
Additional information about an |
individual.last_name |
String | No | |
individual.verification |
Object | No | |
individual.verification.document |
Object | No | |
individual.verification.document.back |
String | No | |
individual.verification.document.front |
String | No | |
individual.first_name |
String | No | |
individual.card_issuing |
Object | No | |
individual.card_issuing.user_terms_acceptance |
Object | No | |
individual.card_issuing.user_terms_acceptance.user_agent |
No | ||
individual.card_issuing.user_terms_acceptance.ip |
String | No | |
individual.card_issuing.user_terms_acceptance.date |
Integer | No | |
individual.dob |
Object | No | |
individual.dob.day |
Integer | Yes | |
individual.dob.month |
Integer | Yes | |
individual.dob.year |
Integer | Yes | |
billing |
Object | No |
The cardholder's billing address. |
billing.address |
Object | Yes | |
billing.address.line2 |
String | No | |
billing.address.line1 |
String | Yes | |
billing.address.postal_code |
String | Yes | |
billing.address.country |
String | Yes | |
billing.address.state |
String | No | |
billing.address.city |
String | Yes | |
company |
Object | No |
Additional information about a |
company.tax_id |
String | No | |
expand[] |
Array | No |
Specifies which fields in the response should be expanded. |
metadata |
Object | No |
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 |
preferred_locales[] |
Array | No |
The cardholder’s preferred locales (languages), ordered by preference. Locales can be |
status |
String | No |
Specifies whether to permit authorizations on this cardholder's cards. Possible values:
|
phone_number |
String | No |
The cardholder's phone number. This is required for all cardholders who will be creating EU cards. See the 3D Secure documentation for more details. |
How to start integrating
- Add HTTP Task to your workflow definition.
- Search for the API you want to integrate with and click on the name.
- This loads the API reference documentation and prepares the Http request settings.
- Click Test request to test run your request to the API and see the API's response.