CardNumberHosted
Description: Use this method to Update an existing customer's credit card related information in the customer vault. This method was designed to be called within an iFrame. The individual components of this form can be customized to match your website's branding requirements. In addition, you can also specify a style sheet (in parameter "CSSUrl") for a customized look-and-feel.
Resource Url: https://webservice.paymentxp.com/wh/EnterCardNumber.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 |
|---|---|---|---|---|
CancelUrl |
No | String | 255 | If specified, the publicly readable url where the response parameters will be posted. If left blank,save results will be sent to our default response page. |
CSSUrl |
No | String | 255 | If specified, the publicly readable url will be referenced to override default css style rules. |
CustomerID |
Yes | String | 50 | The customer's CustomerID |
DisplayStyle |
No | String | 25 | Display predefined display styles. Available settings are "standard" and "flow". Default is "standard". (note: these can be overwritten by setting the CSSUrl parameter.) |
Fingerprint |
Yes | String | 255 | The fingerprint is generated by taking the MD5 hashof the following string: MerchantID^MerchantKey^TimeStamp^CustomerID Note: The MerchantKey must be in uppercase. Also, there is no trailing ^. |
MerchantID |
Yes | String | 5 | The identification that is assigned to the merchant. |
PostBackMethod |
No | String | 255 | "post" or "get" |
PostBackUrl |
No | String | 255 | If specified, the publicly readable url where the response parameters will be posted. If left blank, save results will be sent to our default response page. |
ReturnUrl |
No | String | 255 | The return url that will be displayed on the response page |
ShowCancelButton |
No | String | 1 | Display Cancel Button if set to "1". Set to "0" to hidecancel button. |
ShowCardNumber |
No | String | 1 | Show Card Number Label and Textbox if set to "1". Set to "0" to hide. |
ShowCardNumberLabel |
No | String | 1 | Show Card Number Label if set to "1". Set to "0" to hide. |
ShowExpDate |
No | String | 1 | Show expiration label and textbox if set to "1". Set to "0" to hide. |
ShowExpDateLabel |
No | String | 1 | Show expiration label if set to "1". Set to "0" to hide. |
ShowVariables |
No | String | 1 | For Debugging Purposes. Displays variables receivedfrom post/get. Default is "0". |
SilentPostBackUrl |
No | String | 255 | On submit, the output will be posted to this url. |
Timestamp |
Yes | String | 10 | The Unix epoch time in seconds. (AKA, the number of seconds that have elapsed since January 1, 1970 (midnight UTC/GMT). The timestamp must be with 2 hours of the current Unix Time. For conversion help, see: http://www.epochconverter.com/ |
TransactionType |
Yes | String | 25 | CustomerHosted |
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 |
