Cards

Simulate step-up send passcode

Simulate Visa's send passcode callback for a sandbox card token, after retrieving step-up methods. Column fires the issuing.card_token.send_passcode webhook with a simulated one-time passcode and moves the token to pending_authentication.

Pass one of the returned method identifiers as otp_method_identifier to choose where the passcode goes. When it is omitted, an available method is selected automatically.

post/simulate/issuing/cards/tokens/{card_token_id}/step-up/send-passcode

Request

  • Base URL: https://api.column.com
  • URL: https://api.column.com/simulate/issuing/cards/tokens/{card_token_id}/step-up/send-passcode
  • Auth: HTTP basic

Path parameters

card_token_idstring required

Request body

otp_method_identifierstring nullable

Identifier of the step-up method to deliver the passcode to, as returned by the step-up retrieve-methods endpoint. When omitted, an available method is selected automatically.

Example request

{
  "otp_method_identifier": "a1b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6"
}

Response

Successful response

otp_method_identifierstring required

Identifier of the step-up method the passcode was delivered to.

otp_method_typestring required

The resolved method type the passcode was delivered to (sms or email). Empty when the identifier could not be resolved from the token's persisted step-up map.

passcodestring required

The simulated one-time passcode delivered to the cardholder via the webhook.

Example response

{
  "card_token": {
    "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"
  },
  "otp_method_identifier": "a1b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6",
  "otp_method_type": "sms",
  "passcode": "123456"
}

Changes

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