Assign a spend control to a card

PUT

/cards/:card_id/spend_control

PUT

/cards/:card_id/spend_control

curl -X PUT https://issuing.sandbox.api.thepennyinc.com/cards/card_id/spend_control \
     -H "Authorization: Bearer <token>" \
     -H "Content-Type: application/json" \
     -d '{
  "spend_control_id": "string"
}'

{
  "card_id": "card_019375de-a2a0-7f31-884a-a2a0f3184abd",
  "version": 1,
  "version_time": "2024-01-15T10:30:00Z",
  "issued_time": "2024-01-15T10:30:00Z",
  "expiration_date": "2030-06-30",
  "bin_id": "bin_01937000-0592-7190-87e7-05921907e7c5",
  "bin_range_id": "bin_range_01937b28-f048-77de-8ef4-f0487deef42d",
  "card_product_id": "card_product_01937f5d-a015-7a55-818b-a015a5518b97",
  "business_id": "business_01937b95-484e-75af-8c68-484e5afc68d3",
  "business_entity_id": "business_entity_01937c9d-3a1e-72b0-8881-3a1e2b088159",
  "program_id": "program_019377de-7f88-7f02-894f-7f88f0294fcb",
  "capital_account_id": "account_019372e3-b8dc-7de2-80b6-b8dcde20b6c9",
  "cardholder_id": "cardholder_01937e19-4ebb-75bd-8250-4ebb5bd25085",
  "status": "pending",
  "active": true,
  "terminated": false,
  "currency": "USD",
  "country": "US",
  "usage_type": "single_use",
  "scheme_details": {
    "network": "visa",
    "funding_type": "debit",
    "product_type": "consumer"
  },
  "terminated_time": "2024-01-15T10:30:00Z",
  "bin": "424242",
  "last_four": "4242",
  "control_account_id": "account_019372e3-b8dc-7de2-80b6-b8dcde20b6c9",
  "usage_limits": {
    "authorizations_maximum": 1,
    "authorizations_used": 0,
    "amount_limit": "250.00",
    "amount_remaining": "180.00"
  },
  "alias": "Marketing Team Card",
  "description": "Card issued for the marketing team's advertising spend.",
  "spend_control_id": "spend_control_019379d9-a170-796b-867a-a17096b67a21",
  "client_reference": {
    "id": "order-482910",
    "data": {}
  },
  "form_factor": "virtual"
}

Attach or replace the spend control assigned to a card.

Required permissions: card:update.

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Path parameters

card_idstringRequired

Request

This endpoint expects an object.

spend_control_idstringRequired

The ID of the spend control to assign to the card.

Response

The updated card.

card_idstring

Penny's unique identifier for this card.

versioninteger

A number that increases each time this card's details change. Use it to confirm you are looking at the latest information.

version_timedatetime

The date and time this card's details were last changed.

issued_timedatetime

The date and time this card was issued.

expiration_datedate

The date this card expires and can no longer be used.

bin_idstring

The BIN this card was issued under.

bin_range_idstring

The BIN range this card was issued under.

card_product_idstring

The card product this card was issued under.

business_idstring

The business that owns this card.

business_entity_idstring

The business entity associated with this card.

program_idstring

The program this card was issued under.

capital_account_idstring

The account this card draws funds from.

cardholder_idstring

The cardholder this card is issued to.

statusenum

This card's current lifecycle status.

Allowed values:

activeboolean

Whether this card is currently able to authorize transactions.

terminatedboolean

Whether this card has been permanently terminated.

currencyenum

The currency this card transacts in.

Allowed values:

countrystring

The country this card was issued in, as an ISO 3166-1 alpha-2 code.

usage_typeenum

The usage type this card was issued for.

Allowed values:

scheme_detailsobject

The card network scheme details for this card.

terminated_timedatetime or nullOptional

The date and time this card was terminated, if it has been.

binstring or nullOptional

The first 6-8 digits of the card number, as displayed to end users.

last_fourstring or nullOptional

The last four digits of the card number, as displayed to end users.

control_account_idstring or nullOptional

The control account controlling this card's spend, if one is delegated.

usage_limitsobject or nullOptional

The limits enforcing usage_type and how much of them is used. Present on single_use and single_reload cards only.

aliasstring or nullOptional

A human-readable name for this card, if one has been set.

descriptionstring or nullOptional

A description of this card's purpose, if one has been set.

spend_control_idstring or nullOptional

The spend control policy applied to this card, if one is set.

client_referenceobject or nullOptional

An opaque reference the client attached to this card for their own tracking purposes.

form_factorenumOptionalDefaults to virtual

The form of this card.

Allowed values:

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error

422

Unprocessable Entity Error

429

Too Many Requests Error

500

Internal Server Error