Zip and Country Codes|
Development
Reference Materials
New Sale (Card) 
Description: Provides access to sale creation options.
|
Cards
|
Allows to select a credit card that will be used for this transaction. |
|
Save
|
Saves all changes on the form. |
|
Close
|
Closes the form without saving any changes. |
Detail |
|
Includes general information about new sale within the system.
|
| ¦_ |
Merchant Account
|
Code of Merchant Account to which instance of this object is attributed to.
Depending on the context, Merchant Account Code field may contain either Merchant Code or Merchant Account Code.
The field is primarily used for data partitioning and data management, to make it easy to determine the ownership of a record within the database.
References: Provider Account.Merchant Account Code
|
| ¦_ |
Holder Name
|
Name of a payment card or bank account holder. The value is a concatenation of the firstName and lastName field values separated by a space.
Full name of the holder of the account from which merchant fees are deducted.
References: MerchantChargeInfo.holderName
|
| ¦_ |
Payment Card #/Track Data/Encrypt...
|
Depending on the value which can be entered there are three modes depending on a user's permissions:
Payment card number - user is allowed to enter such sensitive information as raw credit card or bank account number;
Track data - user is allowed to enter such sensitive information as track data;
Encrypted track data - user is not allowed to enter such sensitive information as track data and raw credit card or bank account number; only encrypted card data is allowed to enter. |
| ¦_ |
Token
|
Token that replaces account number for security purposes.
When Tokenization is enabled, each account number is replaced with a token value for persistence. Token code is automatically replaced with a real account number right before the data is sent to a Provider.
The token is stored in its internal representation (value returned by an encryption appliance). When token is returned to a client/submitter, account type and last four digits are added to it.
References: Charge Transaction.Token Code
|
| ¦_ |
Exp Date
|
When transaction is associated with a credit card, the field contains card's expiration date.
When transaction is associated with a bank account, the field contains account's routing number.
References: Charge Transaction.Account Accessory
|
| ¦_ |
CSC
|
CVV2 of the card that is used in the transaction.
Note: the field is transient and is not present in the database
References: Retail Transaction.Cvv2
|
| ¦_ |
Transaction Type
|
Type of transaction to be submitted. |
| ¦_ |
Sale
|
Indicates that sale transaction is going to be submitted. |
| ¦_ |
Auth
|
Indicates that sale-auth transaction is going to be submitted. |
|
Amount
|
Total amount of the transaction.
When partial authorizations are done, amount represents required amount, which may or may not be available.
References: Transaction.Amount
|
|
Tax Amount
|
Amount of tax charged as part of this transaction. The value is included in the total transaction Amount.
References: Charge Transaction.Tax Amount
|
|
Fee Amount
|
Processing fee amount that should be charged to Merchant for processing of this transaction. Process fee amount is included in the total transaction Amount.
References: Charge Transaction.Fee Amount
|
|
Approval Code
|
Authorization code returned by a Provider that approved this transaction.
In some instances might also be used to store response code returned by Provider when transaction declines.
References: Charge Transaction.Approval Code
|
References |
|
Includes values from the transaction submitter's system.
|
| ¦_ |
Item Code
|
Value from the transaction submitter's system.
It is used to assign submitter's specific merchandise code (SKEW#, Bar Code, etc) to the transaction, to identify in the future the reason why this transaction was processed.
Usually, the value will contain a reference to a catalog item for which the payment is collected and is, therefore, only applicable in cases when a payment is collected for a single item.
References: Charge Transaction.Item Code
|
| ¦_ |
Transaction Code
|
Value from the transaction submitter's system.
It is used to assign submitter's specific transaction id to the transaction, to cross reference this transaction between two systems.
Usually, the value will contain a reference to an entity representing this transaction in submitter's front-end system.
References: Charge Transaction.Transaction Code
|
| ¦_ |
Customer Code
|
Value from the transaction submitter's system.
It is used to assign submitter's specific customer (owner) code to the transaction, to identify in the future the ownership of the transaction and to be able to cross reference the value between two systems.
Usually, the value will contain a reference to an record representing an owner of the transaction in the submitter's front-end system.
References: Charge Transaction.Customer Account Code
|
Billing Address |
|
Includes information about billing address.
|
| ¦_ |
Street
|
Street of the billing address.
Both Street 1 line and Street 2 line are combined in this field.
References: Charge Transaction.Street
|
| ¦_ |
City
|
City of the billing address.
References: Charge Transaction.City
|
| ¦_ |
Country
|
Country of the billing address. |
| ¦_ |
State
|
State of the billing address.
References: Charge Transaction.State
|
| ¦_ |
ZIP Code
|
ZIP/Postal code of the billing address.
References: Charge Transaction.ZIP Code
|
| ¦_ |
Phone
|
Billing phone or contact phone of the account holder.
References: Charge Transaction.Phone
|
| ¦_ |
Email
|
Contact email of the account holder.
References: Charge Transaction.Email
|
Shipping Address |
|
Includes information about shipping address.
|
| ¦_ |
Same as Billing
|
Copies all the address information from billing form. |
| ¦_ |
Name
|
First name of the person in the shipping address associated with the order/transaction
References: Charge Transaction.Shipping First Name
|
| ¦_ |
Street
|
Street of the shipping address associated with the order/transaction
References: Charge Transaction.Shipping Street
|
| ¦_ |
City
|
City of the shipping address associated with the order/transaction
References: Charge Transaction.Shipping City
|
| ¦_ |
Country
|
Country of the shipping address. |
| ¦_ |
State
|
State of the shipping address associated with the order/transaction
References: Charge Transaction.Shipping State
|
| ¦_ |
ZIP Code
|
ZIP code of the shipping address associated with the order/transaction.
References: Charge Transaction.Shipping ZIP Code
|
Memo |
|
Includes description of the transaction, might be coming from the submitter's system or assigned internally.
|
Descriptor |
|
Includes information assosiated with underlying merchant (ID number or any additional information about the merchant, specified for each transaction processing).
|
| ¦_ |
Prefix
|
Value, used when transaction is processed through PSP or an aggregator. |
| ¦_ |
Merchant Name
|
Name of the merchant. |
| ¦_ |
Item Description
|
Any additional information about the item. |
| 