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