Site Inspection:

Required Fields

The following fields are required and are usually posted as hidden fields.

Common name FaaS field name Required? Example Posted
Account Token* AccountToken No* ddd31189-9a80-41d9-99e7-fdbb4350893c/14521/39588/
C&P Account number AccountID YES 14521
C&P Account GUID AccountGuid YES ddd31189-9a80-41d9-99e7-fdbb4350893c
Order Mode OrderMode YES Production
Transaction Type TransactionType YES Payment
Postback URL for authorization OnSuccessUrl YES https://domain.com/authorized.html
Postback URL for decline OnDeclineUrl YES https://domain.com/decline.html
Postback URL for error OnErrorUrl YES https://domain.com/error.html
Checkout Page ID WID YES 39588

*Account Token is NOT required if AccountID, AccountGuid, and WID are posted.

Basket Information

The following are the minimum required fields for an item. At least one item has to be included in the basket.

Common name FaaS field name Required? Example Posted
ItemID ItemID YES 1
Item name ItemName YES T-Shirt
Item quantity Quantity YES 1
Item unit price UnitPrice YES 10

Payment Information

Minimum fields required for credit card authorization are as follows:

Common name FaaS field name Required? Example Posted
First name BillingFirstName YES John
Last name BillingLastName YES Smith
Payment Type PaymentType YES CreditCard
Credit card # CardNumber YES 4111111111111111
Expiration Date ExpirationDate
See note 10/20
Expiration Month* ExpirationMonth See note 10
Expiration Year* ExpirationYear See note 20
CV2 Cvv2 YES 123

*The credit card expiration date is required and may be passed as either the Expiration Date or the 2 parameter set Expiration Month & Expiration Year.

The following provides a detailed list of field names in the FaaS platform and the values posted:

Card Holder Information

Common name FaaS Field name Example Maximum Length Posted
First Name BillingFirstName John 50
Middle Initial BillingMI G 1
Last name BillingLastName Doe 50
Email BillingEmail John.Doe@Test.com 50
BillingPhone BillingPhone 555.111.2222 50

Billing Address [Optional]

Common name FaaS Field name Example Maximum Length Posted
Address1 BillingAddress1 2200 Kraft Drive 100
Address2 BillingAddress2 Building B 100
Address3 BillingAddress3 Suite 1175 100
City BillingCity Blacksburg 50
State or Province BillingStateProvince VA 50
Postal Code BillingPostalCode 24060 20
Country Code BillingCountryCode 840 3

Shipping Address [Optional]

Common name FaaS Field name Example Maximum Length Posted
First Name ShippingFirstName John 50
Middle Initial ShippingMI C 1
Last Name ShippingLastName Smith 50
Email ShippingEmail John.Smith@domain.com 50
Phone ShippingPhone 123 456 7890 50
Address1 ShippingAddress1 2200 Kraft Drive 100
Address2 ShippingAddress2 Building B 100
Address3 ShippingAddress3 Suite 1175 100
City ShippingCity Blacksburg 50
State or Province ShippingStateProvince Virginia 50
Postal Code ShippingPostalCode 24060 20
Country Code ShippingCountryCode 840 3

Custom Questions [Optional]

Common name FaaS Field name Example Maximum Length Posted

eNewsletter Subscription [Optional]

Product Information

Shipping Information [Optional]

Common name FaaS Field name Example Maximum Length Posted
Method ShippingMethod FedEx 20
Fee ShippingValue 30 50
Tax ShippingTax 2 50

Receipt Information

Common name FaaS Field name Example Maximum Length Posted
WID [Required] 1 WID 8354 10
Send Receipt SendReceipt true <10
Notification List EmailNotificationList test@test.com 45 [per email] separated by semi-colon
Transaction Type 2 TransactionType Payment Authorize / Payment

Recurring Transactions [Optional]

Common name FaaS Field name Example Maximum Length Posted
Recurring Method RecurringMethod Subscription Subscription
Installment
Number of payments* Installment 12 20
Periodicity Periodicity Month Week
2 Weeks
Month
2 Months
Quarter
6 Months
Year

Mobile Payment [Optional]

Common name FaaS Field name Example Maximum Length Posted
Cell phone number* CellPhoneNumber 15401234567 25

Payment Information

Credit Card

Common name FaaS Field name Example Maximum Length Posted
Payment Type PaymentType CreditCard CreditCard
Check
Invoice
Purchase Order
Name On Card NameOnCard John Smith 50
Card Number CardNumber 4111111111111111 17
Cvv2 Cvv2 123 4
Expiration Date* ExpirationDate 04/15 5
Expiration Month ExpirationMonth 04 2
Expiration Year ExpirationYear 15 2

Check

Gateway: Transfirst

Common name FaaS Field name Example Maximum Length Posted
Payment Type PaymentType Check Check
Routing Number RoutingNumber 123456 9
Account Number AccountNumber 123456 17
Account Type AccountType CheckingAccount CheckingAccount
SavingsAccount
Check Type CheckType Company Company
Personal
Check Number CheckNumber 12345 10

Gateway: Global Payments

Common name FaaS Field name Example Maximum Length Posted
ID Type IdType Driver Driver
Military
State
ID Number IdNumber 12345678910 30
ID State Code IdStateCode VA [state abbreviation code]

Invoice

Common name FaaS Field name Example Maximum Length Posted
Payment Type PaymentType Invoice
Invoice Number InvoiceNumber 12345 50

Purchase Order

Common name FaaS Field name Example Maximum Length Posted
Payment Type PaymentType PurchaseOrder
Purchase Order Number PurchaseOrderNumber 123456789 50

Service Response

Common name FaaS Field name Example Maximum Length Posted
Authorization URL OnSuccessUrl https://domain.com/authorize.html 100
Decline URL OnDeclineUrl https://domain.com/decline.html 100
Error URL OnErrorUrl https://domain.com/error.html 100

Reference ID [Optional]

Common name FaaS Field name Minimum Length Maximum Length Posted
Reference ID RefID 0 No Limit

Account Information

Common name FaaS Field name Example Maximum Length Posted
GUID AccountGuid ddd31189-9a80-41d9-99e7-fdbb4350893c 36
Account ID* AccountID 14521 10

Order Mode

Common name FaaS Field name Example Maximum Length Posted
Order Mode OrderMode Production Production / Test
Tracker Tracker Campaign123 50
Campaign Campaign Spring 2011 80

DecimalMark [Optional]

Common name FaaS Field name Values Maximum Length Posted
DecimalMark DecimalMark US, ISO  (Default = US) 3

Convenience Fee [Optional]

Convenience fee may be added to approved transaction types.

Common name FaaS Field name Example Maximum Length Posted
Convenience Fee Rate ConvenienceFeeRate 3 (for 3%)
Convenience Fee Fixed ConvenienceFreeFixed 1.50 (for $1.50)

Postback [Optional]

Postback method may be set to Post or Get for the authorization response.

Common name FaaS Field name Example Maximum Length Posted
Postback Postback Post or Get n/a

ChargeDate [Optional]

Common name FaaS Field name Example Maximum Length Posted
Charge date YEAR ChargeDateYear 2013 4
Charge date MONTH ChargeDateMonth 10 2
Charge date DAY ChargeDateDay 25 2