Overview
Error Handling

Methods

API Documentation (API Version bleed)

Billing/CreditCard/Profile/

DESCRIPTION

This section contains methods for managing credit card customer profiles.

apply

URL:

https://api.liquidweb.com/bleed/Billing/CreditCard/Profile/apply

Description:

Designate a credit card payment profile to be used as the credit card on file for the specified account.

Parameters:

ParameterType
payment_profile_idA positive integer value (i.e. 1 and up).

Returns:

FieldType
cc_expA valid month/year in MM/YYYY format.
cc_tokenA credit card number with only the last four digits exposed, preceded by any number of X's (i.e. XXXXXXXXXXXX1234).
payment_methodA valid payment method (check, credit_card, ach, paypal, paypal_agreement).
payment_profile_idA positive integer value (i.e. 1 and up).

Possible Errors:

Refer to the Error Handling documentation for the list of exception types

applyOpaque

URL:

https://api.liquidweb.com/bleed/Billing/CreditCard/Profile/applyOpaque

Description:

Applies a credit card to be used as the payment profile using AuthorizeNet Apply.js' opaqueData process

Parameters:

ParameterTypeNotes
opaqueDataAn associative array containing the fields:* Required
 
dataDescriptorA string of text, containing no newlines or other control characters.* Required
dataValueA string of text, containing no newlines or other control characters.* Required

Returns:

FieldType
cc_expA valid month/year in MM/YYYY format.
cc_issuerA single word, consisting of only letters and digits.
cc_tokenA credit card number with only the last four digits exposed, preceded by any number of X's (i.e. XXXXXXXXXXXX1234).
payment_methodA valid payment method (check, credit_card, ach, paypal, paypal_agreement).
payment_profile_idA positive integer value (i.e. 1 and up).

Possible Errors:

Refer to the Error Handling documentation for the list of exception types

details

URL:

https://api.liquidweb.com/bleed/Billing/CreditCard/Profile/details

Description:

Get details for a profile.

Parameters:

ParameterTypeNotes
customer_uuidA valid UUID (Universally Unique IDentifier).* Required if:
  • accnt is not given
payment_profile_idA positive integer value (i.e. 1 and up).

Returns:

FieldTypeNotes
addressA string permitting tabs, carriage returns and newlines* Optional
cc_expA valid month/year in MM/YYYY format.
cc_issuerA single word, consisting of only letters and digits.* Optional
cc_tokenA credit card number with only the last four digits exposed, preceded by any number of X's (i.e. XXXXXXXXXXXX1234).
cityA string permitting tabs, carriage returns and newlines* Optional
companyA string permitting tabs, carriage returns and newlines* Optional
countryA string permitting tabs, carriage returns and newlines* Optional
customer_uuidA valid UUID (Universally Unique IDentifier).* Optional
faxA string permitting tabs, carriage returns and newlines* Optional
fnameA string permitting tabs, carriage returns and newlines* Optional
lnameA string permitting tabs, carriage returns and newlines* Optional
payment_methodA valid payment method (check, credit_card, ach, paypal, paypal_agreement).* Optional
payment_profile_idA positive integer value (i.e. 1 and up).
phoneA string permitting tabs, carriage returns and newlines* Optional
stateA string permitting tabs, carriage returns and newlines* Optional
zipA string permitting tabs, carriage returns and newlines* Optional

Possible Errors:

Refer to the Error Handling documentation for the list of exception types

hostedFormToken

URL:

https://api.liquidweb.com/bleed/Billing/CreditCard/Profile/hostedFormToken

Description:

Get a form_token that can be used to present the Authorize.net Hosted Form.

Parameters:

ParameterType
communicator_urlA valid http or https uri (i.e. http://www.liquidweb.com).
customer_uuidA valid UUID (Universally Unique IDentifier).
reasonOne of: 'default', 'onetime'

Returns:

FieldTypeNotes
accntA valid account number, up to 6 digits in length.* Optional
customer_uuidA valid UUID (Universally Unique IDentifier).* Optional
form_tokenA string permitting tabs, carriage returns and newlines

Possible Errors:

Refer to the Error Handling documentation for the list of exception types

oneTimeDetails

URL:

https://api.liquidweb.com/bleed/Billing/CreditCard/Profile/oneTimeDetails

Description:

Get details for a one-time payment profile. A one-time payment profile is considered the newest payment profile not currently on file as the account credit card.

Parameters:

No Values Defined

Returns:

FieldTypeNotes
cc_expA valid month/year in MM/YYYY format.* Optional
cc_issuerA single word, consisting of only letters and digits.* Optional
cc_tokenA credit card number with only the last four digits exposed, preceded by any number of X's (i.e. XXXXXXXXXXXX1234).* Optional
payment_methodA valid payment method (check, credit_card, ach, paypal, paypal_agreement).* Optional
payment_profile_idA positive integer value (i.e. 1 and up).* Optional

Possible Errors:

Refer to the Error Handling documentation for the list of exception types

remove

URL:

https://api.liquidweb.com/bleed/Billing/CreditCard/Profile/remove

Description:

Removes any existing credit card profile and sets the account's payment method to check.

Parameters:

No Values Defined

Returns:

FieldType
payment_methodA valid payment method (check, credit_card, ach, paypal, paypal_agreement).

Possible Errors:

Refer to the Error Handling documentation for the list of exception types

updateOpaque

URL:

https://api.liquidweb.com/bleed/Billing/CreditCard/Profile/updateOpaque

Description:

Updates a credit card payment profile using AuthorizeNet Apply.js' opaqueData process

Parameters:

ParameterTypeNotes
opaqueDataAn associative array containing the fields:* Required
 
dataDescriptorA string of text, containing no newlines or other control characters.* Required
dataValueA string of text, containing no newlines or other control characters.* Required

Returns:

FieldType
cc_expA valid month/year in MM/YYYY format.
cc_issuerA single word, consisting of only letters and digits.
cc_tokenA credit card number with only the last four digits exposed, preceded by any number of X's (i.e. XXXXXXXXXXXX1234).
payment_methodA valid payment method (check, credit_card, ach, paypal, paypal_agreement).
payment_profile_idA positive integer value (i.e. 1 and up).

Possible Errors:

Refer to the Error Handling documentation for the list of exception types