Cards

Simulate approve provisioning

Simulate a digital wallet's provisioning request for a card token in pending_activation status, as returned by the token eligibility check. Set wallet_type to apple_pay, google_pay, or samsung_pay to attribute the token to a wallet.

Set action_code to approve, decline, or step_up to force the decision without calling your decision.issuing.card_token endpoint. When it is omitted, the decision flows through Column's real provisioning decisioning, including that endpoint. A step_up decision also simulates the step-up methods and send passcode callbacks when the cardholder has contact info on file, leaving the token ready for step-up completion.

post/simulate/issuing/cards/tokens/{card_token_id}/approve-provisioning

Request

Base URL: https://api.column.com
URL: https://api.column.com/simulate/issuing/cards/tokens/{card_token_id}/approve-provisioning
Auth: HTTP basic

Path parameters

card_token_idstring required

Request body

action_codestring nullable

Network-specific action code to apply to the provisioning decision.

device_namestring nullable

A human-readable identifier for the device requesting provisioning.

device_type'mobile_phone' | 'tablet' | 'watch' nullable

The category of device requesting provisioning.

token_requestor_namestring nullable

Name of the entity that initiated the provisioning request.

token_typestring nullable

The type of payment token being provisioned.

wallet_typestring nullable

The wallet provider (e.g. apple_pay, google_pay).

Example request

{
  "device_type": "mobile_phone"
}

Response

Successful response

activation_denied_atstring date-time nullable

Timestamp when the token entered activation_denied status

card_account_idstring required

The ID of the card account

card_idstring required

The ID of the card

card_program_idstring required

The ID of the card program

created_atstring date-time required

The creation timestamp of the card token

deactivated_atstring date-time nullable

Timestamp when the token was deactivated

device_namestring nullable

The name of the device the token is provisioned to

The type of device the token is provisioned to. Possible values: mobile_phone, tablet, watch, mobile_phone_or_tablet, pc, ecommerce, unknown

first_activated_atstring date-time nullable

Timestamp when the token was first activated

first_paused_atstring date-time nullable

Timestamp when the token was first paused

idstring required

The ID of the card token

last_activated_atstring date-time nullable

Timestamp when the token was last activated

last_paused_atstring date-time nullable

Timestamp when the token was last paused

network_token_reference_idstring

The network token reference used to identify this token in wallet SDKs. Available for Visa tokens when assigned by the network.

pending_activation_atstring date-time nullable

Timestamp when the token entered pending_activation status

pending_authentication_atstring date-time nullable

Timestamp when the token entered pending_authentication status

requestor_namestring nullable

The name of the token requestor (e.g., the digital wallet provider)

The status of the card token

stepping_up_atstring date-time nullable

Timestamp when the token entered stepping_up status

token_type'wallet' | 'card_on_file' nullable

The type of token. Possible values: wallet, card_on_file

wallet_type'apple_pay' | 'google_pay' | 'samsung_pay' | 'unknown' required

The type of digital wallet. Possible values: apple_pay, google_pay, samsung_pay, unknown

Example response

{
  "card_account_id": "cacc_2x8gszy5folpA9s0TOCseE9ABDM",
  "card_id": "card_2x8gszy5folpA9s0TOCseE9ABDM",
  "card_program_id": "cpgm_2x8gszy5folpA9s0TOCseE9ABDM",
  "device_name": "iPhone",
  "device_type": "mobile_phone",
  "id": "ctkn_2x8gszy5folpA9s0TOCseE9ABDM",
  "network_token_reference_id": "DNITHE302312345678901234",
  "requestor_name": "Apple Pay",
  "status": "active",
  "token_type": "wallet",
  "wallet_type": "apple_pay"
}

Changes

No recorded changes to this operation across all 1 revision of this API.