Skip to main content (Press Enter)
Helcim Logo
Click here if you return to contents

Add or Edit a Credit Card

This API call lets you add a new credit card to a specific customer. The response is an XML of the available new credit card information.

Request Fields

Field Name Type Required Description
action String Yes customerCardEdit
accountId Integer Yes The Helcim Commerce account ID.
apiToken String Yes API token used for authentication and access control.
customerCode String Yes The customer code.
cardHolderName String Yes The card holder's name.
cardNumber Integer Yes The credit card number.
cardExpiry String Yes The credit card expiry date.
cardCVV Integer No The card verification value.
cardToken String No If entered, user is editing an existing card.
default Integer No 1 or 0. Whether the card is set as default or not.
cardHolderAddress String No The card holder's address.
cardHolderPostalCode String No The card holder's postal code.
terminalId Integer No The terminal ID.
verify Integer No 1 or 0. Whether the card will be verified or not.

Response Fields (XML)

Field Name Type Description
message - XML structure
response Integer 1 or 0. Whether the new credit card was added or not.
responseMessage String Response message confirming actions taken.
customer - XML structure
customerCode String the customer code.
businessName String The business name.
contactName String The contact name.
card - XML structure
cardNumber Integer The credit card number (first four and last four digits only).
cardToken String The credit card token.
cardF4L4 Integer The first four and last four credit card digits.
dateLastUsed String The date the credit card was last used.


For all API requests, there are also generic API authentication and user access restriction errors.

Response Code Error Code Message Description
0 - Invalid Customer Code The customer code you provided cannot be found.
0 - Invalid credit card number (Lunh Check) The credit card number you provided is invalid, or not entered.
0 - Invalid Field - Cardholder Name The card holder's name is invalid, or not entered.
0 - Card has expired The credit card has expired, or the credit card expiry date was not entered.

Related Articles

View a Customer
Add or Edit a Customer
Add or Edit a Bank Account
List Customers
List Detailed Customers

Was this article helpful?

Feedback submitted - Thank you!

If you need immediate assistance please contact our Merchant Experience Specialists here

Click here if you return to the content