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 |