Customer Vault

AddCustomer

Description: Use this function to add a new customer record. Below are the parameters for this method.

Resource Url: https://webservice.paymentxp.com/wh/WebHost.aspx

Method: POST

Content-Type: application/x-www-form-urlencoded

Notes

  • Parameters in bold are required in the request for example, BillingNameFirst

Request

Parameter Is Required Data Type Max Length Description
AccountName No String 50 Your customer's name on account (First name + Last name)
AccountNumber No String 17 Your customer's Bank Account Number without space orhyphen
Address No String 50 Your customer's address
BankAccountType No String 2 Your customer's Bank Account Type: CK = Checking Account SA = Savings Account
BankName No String 50 Your customer's bank name
CardExpirationDate No Number 4 Your customer's card expiration date
CardNumber No Number 60 Your customer's credit number
City No String 50 Your customer's city
Country No String 50 Your customer's country
CustomerID Yes String 50 Your customer's ID Leave this field empty if you’re using a KORT Payments Token
CustomerName Yes String 50 Your customer's full name (First name + Last name)
Email No String 50 Your customer's email address
Fax No String 25 Your customer's fax
FirstName No String 50 Your customer's first name
LastName No String 50 Your customer's last name
MerchantID Yes String 10 Unique ID assigned by KORT Payments
MerchantKey Yes String 36 Unique Key assigned by KORT Payments Leave this field empty if you’re using a KORT Payments Token
Phone No String 25 Your customer's phone number
RoutingNumber No Number 9 Your customer's bank routing number
State No String 25 Your customer's state
Token No String 40 KORT Payments Token
TransactionType Yes String 19 AddCustomer
Zip No String 25 Your customer's zip code

Response

Field Name Description
PostedDate The date and time the transaction was posted.
StatusID The result of the transaction. Status 1 indicates an approved transaction.
Message The message from the processor.
Status Status description
CardNumber Last 4 digits of the card number
CustomerName The name of the account holder as it appears on the account
BillingNameFirst The first name of the account holder.
BillingNameLast The last name of the account holder.
Address The billing address of the cardholder. Used to check for AVS identification.
City The billing city of the cardholder.
State The billing state of the cardholder.
Zip The billing zip code of the cardholder. Used to check forAVS identification.
Country The billing country of the cardholder.
Phone The phone number of the cardholder.
Fax The fax number of the cardholder.
Email The e-mail address of the cardholder.
BankName Your customer's bank name.
AccountName Your customer's name on account (First name + Last name).
RoutingNumber Routing number or ABA.
AccountNumber The last 4 of the Account Number or DDA.
CardExpirationDate Your customer's card expiration date.
BankAccountType Your customer's Bank Account Type: CK = Checking Account SA = Savings Account