Fraud
Last updated
Was this helpful?
Last updated
Was this helpful?
This page contains all API documentation for Gift Card transactions. For more information regarding account access, navigate to the parent page.
POST fraud:submit
xCommand = fraud:submit
The Submit command is used in conjunction with a valid FraudWatch account to submit e-commerce transactions for a fraud verification check.
xCardNum*
String
Masked Card number with BIN and last 4 digits exposed
xKey*
String
Your Cardknox API key.
xVersion*
String
Gateway API version. The current version is 5.0.0.
xSoftwareName*
String
Name of your software
xSoftwareVersion*
String
Version number of your software
xCommand*
String
Cardknox transaction type
xAmount*
String
The total amount of the transaction, inclusive of tax and tip if applicable. This the total amount of the transaction
xCustom01
String
20 custom fields are available for custom data such as customer comments, etc. Use xCustom01 through xCustom20
xInvoice*
String
The merchant’s invoice number for the transaction. xInvoice is recommended when available for improved duplicate handling
xIP*
String
The customer’s IP address. Typically used for fraud detection
xEmail*
String
The customer’s email address
xBillFirstName*
String
The customer’s first name for their billing profile
xBillLastName*
String
The customer’s last name for their billing profile
xBillStreet*
String
The customer’s street address for their billing profile
xBillCity*
String
The customer’s city for their billing profile
xBillState*
String
The customer’s state for their billing profile
xBillZip*
String
The customer’s zip code for their billing profile
xBillPhone*
String
The customer’s phone number for their billing profile
xShipFirstName*
String
The customer’s first name for their shipping profile
xShipLastName*
String
The customer’s last/family name for their shipping profile
xShipStreet*
String
The customer’s street address for their shipping profile
xShipCity*
String
The customer’s city for their shipping profile
xShipState*
String
The customer’s state for their shipping profile
xShipZip*
String
The customer’s zip code for their shipping profile
xShipPhone*
String
The customer’s phone number for their shipping profile
xGatewayRefNum*
String
Transaction RefNum received from gateway for FraudWatch verification
xGatewayResult*
String
Transaction status received from gateway for FraudWatch verification (Approved/Declined/Error)
xGatewayCVV*
String
CVV for FraudWatch verification
xGatewayAVS*
String
Street address for FraudWatch verification
xOrderType*
String
Specifies if the order origin is internet OR phone for FraudWatch verification
xExistingCustomer*
String
Yes/No value indicating if the customer is a repeat customer
xShipEmail*
String
The ShipTo email address
xOrderID
String
Unique order number for FraudWatch verification
xExistingCustomer
String
Yes/No value indicating if customer is a repeat customer
xAllowDuplicate
String
By default, Cardknox rejects duplicate transactions within 10 minutes of the original transaction. This command overrides that safeguard. True/False allowed.
xName
String
The cardholder’s name
xTax
String
The tax portion that is included in the total transaction amount (xAmount)
xTip
String
The tip portion that is included in the total transaction amount (xAmount)
xPONum
String
The merchant’s purchase order number for the transaction
xDescription
String
Additional data that is optionally passed along for reporting
xShipMiddleName
String
The customer’s middle name for their shipping profile
xBillMiddleName
String
The customer’s middle name for their billing profile
xBillStreet2
String
The customer’s second line street address for their billing profile
xShipStreet2
String
The customer’s second line street address for their shipping profile
xShipCountry
String
The customer's country code for their shipping profile
xBillCountry
String
The custom's country code for their billing profile
xBillMobile
String
The customer’s mobile phone number for their billing profile
xGatewayError
String
Transaction RefNum received from gateway for FraudWatch verification
xComments
String
Additional data that is optionally passed along to the receipt
xFax
String
The customer’s fax number.
xOrderItems
String
Summary of products ordered
xCustomerComments
String
Comments submitted by customer along with order
xShipMethod
String
The shipping carrier/service used
xShipAmount
String
The total cost of shipping charges
xSupports64BitRefnum
String
True/False value indicating that the user’s system can handle a 64bit refnum getting returned on request to the transaction.