Token Update - ccupdatetoken

This section describes the message parameters for Card Manager Token Update transaction processing, which you can submit using the XML API integration method. Refer to the Integration Methods section for more information.

The ccupdatetoken transaction updates the information associated with a token.

In this section:

Request

note

You can verify the account before the update. If the card is declined, the token will not update.
Only include the parameters you want to update.
You can set some parameters to null by sending empty values.

Field name	Description	Required	Length	Data type
`ssl_merchant_id`	Merchant ID Elavon-assigned Converge account ID.	Required	15	numeric
`ssl_user_id`	Converge User ID The user ID with Hosted Payment API User status that can send transaction requests through the terminal.	Required	15	alphanumeric
`ssl_pin`	Terminal ID Unique identifier of the terminal that will process the transaction request and submit to the Converge gateway. The `ssl_user_id` sending the transaction request must be associated with the terminal that will process the request.	Required	64	alphanumeric
`ssl_transaction_type`	Transaction Type Value:`ccupdatetoken`	Required	20	alphanumeric
`ssl_first_name`	First Name First name on the cardholder’s / customer’s account or billing address.	Required	20	alphanumeric
`ssl_last_name`	Last Name Last name on the cardholder’s / customer’s account or billing address.	Required	30	alphanumeric
[Card Data]
`ssl_token`	Credit Card Token The Token ID to update. Important: - The token must already be stored in Card Manager. - Use only if the terminal is set up with the Tokenization terminal option.	Required	20	alphanumeric
`ssl_card_number`	Card Number Card Number as it appears on the credit card. Important: Submitting the card number generates a new token.	Optional	18	numeric
`ssl_exp_date`	Card’s Expiry Date Date when the card becomes invalid. Format: MMYY	Optional	4	numeric
`ssl_exclude_account_update`	Exclude Account Update A request with this field set to `Y` will not pass a token to the account updater.	Optional	1	Boolean
[Account Data]
`ssl_company`	Company Name Company name on the cardholder’s / customer’s account or billing address.	Optional	50	alphanumeric
`ssl_customer_id`	Customer ID Merchant-defined unique customer identifier.	Optional	-	-
`ssl_avs_address`	Address Line 1 The house number and street name on the cardholder’s / customer’s account or billing address.	Optional	30	alphanumeric
`ssl_address2`	Address Line 2 Apartment or condominium unit number and floor number on the cardholder’s or customer’s account or billing address.	Optional	30	alphanumeric
`ssl_avs_zip`	Postal or ZIP Code Postal or ZIP code on the cardholder’s or customer’s account or billing address.	Optional	9	alphanumeric
`ssl_city`	City City name on the cardholder’s / customer’s account or billing address.	Optional	30	alphanumeric
`ssl_state`	State Code State or province code on the cardholder’s / customer’s account or billing address.	Optional	2	alphanumeric
`ssl_country`	Country ISO Code Country ISO code on the cardholder’s / customer’s account or billing address.	Optional	3	alphanumeric
`ssl_email`	Email Address The cardholder’s or customer’s email address.	Optional	100	alphanumeric
`ssl_phone`	Phone Phone number on the cardholder’s / customer’s account or billing address. Format: Must not include spaces or dashes.	Optional	10	numeric
`ssl_description`	Merchant-defined Transaction Description Short and custom text to describe the transaction.	Optional	255	alphanumeric
[AVS/CVV Verification]
`ssl_verify`	Account Verification Indicator Indicates whether Converge needs to verify the account before generating a token. Valid values: `Y` - Verify account prior to token generation `N` - Generate token without account verification	Optional	1	alphanumeric

Response

Field name	Description
`ssl_result`	Token Update Result Code An `ssl_result` = 0 indicates a generated token. An `ssl_result` = 1 indicates that a token is not generated. Important: Returned only if `ssl_verify` = Y.
`ssl_result_message`	Account Verification Result Message Refer to the Account Verification Response Message section for an extensive list of possible returned messages. Important: Returned only if `ssl_verify` = Y.
`ssl_txn_id`	Transaction ID Unique identifier of the transaction. Important: Returned only if `ssl_verify` = Y.
`ssl_txn_time`	Processing Date and Time Indicates when Converge processed the transaction. Format: MM/DD/YYYY hh:mm:ss AM/PM Example: 03/18/2010 10:34:10 AM Important: Returned only if `ssl_verify` = Y.
`ssl_approval_code`	Transaction Approval Code Unique code that indicates the approval status of the transaction. Important: Returned only if `ssl_verify` = Y.
`ssl_token`	Token Token supplied in the update request.
`ssl_token_response`	Token Update Outcome A value of `SUCCESS` indicates Converge generated the token. Other values returned are `FAILURE`, `Action Not Permitted`, `Invalid Token`, `Not Permitted`, and `Acct Verification Failed`.
`ssl_avs_response`	Address Verification Response Code Refer to the AVS Response Codes section for a complete list of AVS response codes. Important: Returned only if `ssl_verify` = Y.
`ssl_cvv2_response`	Card Verification Response Code Refer to the CVV2/CVC2 Response Codes section for a complete list of CVV/CVC2 response codes. Important: Returned only if `ssl_verify` = Y.
`ssl_card_number`	Masked Card Number Converge only returns the first 2 or last 4 digits of the regular PAN, or the last 4 digits of the actual card number if it is an association token (example, ApplePay).
`ssl_exp_date`	Card’s Expiry Date Returned based on merchant setup.
`ssl_company`	Company Name Company name on the cardholder’s / customer’s account or billing address. Returned based on merchant setup.
`ssl_customer_id`	Customer ID Merchant-defined unique customer identifier. Returned based on merchant setup.
`ssl_first_name`	First Name First name on the cardholder’s / customer’s account or billing address. Returned based on merchant setup.
`ssl_last_name`	Last Name Last name on the cardholder’s / customer’s account or billing address. Returned based on merchant setup.
`ssl_avs_address`	Address Line 1 Commonly the house number and street name on the cardholder’s / customer’s account or billing address. Returned based on merchant setup.
`ssl_address2`	Address Line 2 Apartment or condominium unit number and floor number on the cardholder’s or customer’s account or billing address. Returned based on merchant setup.
`ssl_avs_zip`	Postal or ZIP Code Postal or ZIP code on the cardholder’s or customer’s account or billing address. Returned based on merchant setup.
`ssl_city`	City City name on the cardholder’s / customer’s account or billing address. Returned based on merchant setup.
`ssl_state`	State Code State or province code on the cardholder’s / customer’s account or billing address. Returned based on merchant setup.
`ssl_country`	Country ISO Code Country ISO code on the cardholder’s / customer’s account or billing address. Returned based on merchant setup.
`ssl_phone`	Phone Phone number on the cardholder’s / customer’s account or billing address. Returned based on merchant setup.
`ssl_email`	Email Address The cardholder’s or customer’s email address. Returned based on merchant setup.
`ssl_description`	Merchant-defined Transaction Description Short and custom text to describe the transaction. Returned based on merchant setup.
[Error]	Returned only if an error occurs. Refer to the Error Codes section for more information.
`errorCode`	Error Code Typically, when the transaction failed validation or the request is incorrect. This will prevent the transaction from going to authorization. This is a numeric field.
`errorMessage`	Error Message Detailed explanation of the error. This field may be changed based on merchant configuration in the user interface.
`errorName`	Error Name Error name or reason for the error.