POST /v1/issuing/cards/{card}

Updates the specified Issuing Card object by setting the values of the parameters passed. Any parameters not provided will be left unchanged.

Servers

Path parameters

Name Type Required Description
card 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 for this card. 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:

  • "monthly"
  • "per_authorization"
  • "weekly"
  • "yearly"
  • "all_time"
  • "daily"
spending_controls.spending_limits[].categories[] Array No
spending_controls.spending_limits[].amount Integer Yes
spending_controls.allowed_merchant_countries[] Array No
spending_controls.allowed_categories[] Array No
spending_controls.blocked_categories[] Array No
personalization_design String No
expand[] Array No

Specifies which fields in the response should be expanded.

cancellation_reason String No

Reason why the status of this card is canceled.

Possible values:

  • "lost"
  • "stolen"
metadata 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 metadata.

shipping Object No

Updated shipping information for the card.

shipping.name String Yes
shipping.address_validation Object No
shipping.address_validation.mode String Yes

Possible values:

  • "disabled"
  • "normalization_only"
  • "validation_and_normalization"
shipping.require_signature Boolean No
shipping.service String No

Possible values:

  • "standard"
  • "express"
  • "priority"
shipping.type String No

Possible values:

  • "individual"
  • "bulk"
shipping.customs Object No
shipping.customs.eori_number String No
shipping.address Object Yes
shipping.address.line2 String No
shipping.address.line1 String Yes
shipping.address.postal_code String Yes
shipping.address.country String Yes
shipping.address.state String No
shipping.address.city String Yes
shipping.phone_number String No
status String No

Dictates whether authorizations can be approved on this card. May be blocked from activating cards depending on past-due Cardholder requirements. Defaults to inactive. If this card is being canceled because it was lost or stolen, this information should be provided as cancellation_reason.

Possible values:

  • "inactive"
  • "active"
  • "canceled"
pin Object No

The desired new PIN for this card.

pin.encrypted_number String No

How to start integrating

  1. Add HTTP Task to your workflow definition.
  2. 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.
  3. Click Test request to test run your request to the API and see the API's response.