requestCreditCardChange

Classes SoftLayer_Account
Tags method sldn account

SoftLayer_Account::requestCreditCardChange

Retrieve the record data associated with the submission of a Credit Card Change Request.

Description

Retrieve the record data associated with the submission of a Credit Card Change Request. Softlayer customers are permitted to request a change in Credit Card information. Part of the process calls for an attempt by SoftLayer to submit at $1.00 charge to the financial institution backing the credit card as a means of verifying that the information provided in the change request is valid. The data associated with this change request returned to the calling function.

If the onlyChangeNicknameFlag parameter is set to true, the nickname of the credit card will be changed immediately without requiring approval by an agent. To change the nickname of the active payment method, pass the empty string for paymentRoleName. To change the nickname for the alternate credit card, pass ALTERNATE_CREDIT_CARD as the paymentRoleName. vatId must be set, but the value will not be used and the empty string is acceptable.

Parameters

Name Type Description
request SoftLayer_Billing_Payment_Card_ChangeRequest Details required to request a credit card change.
vatId string EU member states VAT ID.
paymentRoleName string keyName of the card’s payment role
onlyChangeNicknameFlag boolean

Required Headers

Optional Headers

Return Values

Error Handling

  • Throw the error “The customer is enrolled in payer authentication. Authenticate the cardholder before continuing with the transaction. ACSUrl={access control server url} | PAReq={payer authentication request message} | TransactionID={Transaction ID}” occurs when payer authentication is required. The error message contains additional applicable data to support continuation of authentication via Cardinal Cruise Hybrid. You must take the ACSUrl, PAReq, and TransactionID and include them in the Cardinal.continue function in order to proceed with the authentication session. NOTE: In the Cardinal.continue function, the ‘Payload’ field value should be populated with the data from PAReq. 
curl -g -u $SL_USER:$SL_APIKEY -X POST -d '{"parameters": [SoftLayer_Billing_Payment_Card_ChangeRequest, string, string, boolean]}' \
'https://api.softlayer.com/rest/v3.1/SoftLayer_Account/requestCreditCardChange'