Attribute Data Type Field Type Description
amount currency O Dollar amount of the transaction. Must be a positive number up to two decimal places.
transaction_id string R A unique identifier for each transaction in the PayTrace system. This unique identifier is returned in the transaction_id attribute of an API response.
csc string O CSC is the 3 or 4 digit code found on the signature line of the credit card. CSC is found on the front of Amex cards. This attribute is only required if the "Require CSC" field is enabled on the Security Settings page of the PayTrace Virtual Terminal.
encrypted_csc string O Replaces the csc attribute when submitting CSC values that are encrypted by the PayTrace Client-Side Encryption JavaScript Library. This attribute is only required if the "Require CSC" field is enabled on the Security Settings page of the PayTrace Virtual Terminal.
billing_address object O C Supporting attributes listed below. This object is only required if the "Require Billing Address" and/or "Require Billing Zip" fields are enabled on the Security Settings page of the PayTrace Virtual Terminal
billing_address.name string O Name that appears on the credit card.
billing_address.street_address string O C Street Billing Address that is on file for the cardholder's account. This attribute is only required if the "Require Billing Address"field is enabled on the Security Settings page of the PayTrace Virtual Terminal
billing_address.street_address2 string O Second line of the Street Billing Address that is on file for the cardholder's account.
billing_address.city string O City of the Billing Address that is on file for the cardholder's account.
billing_address.state string O State of the Billing Address that is on file for the cardholder's account.
billing_address.zip string O C Zipcode of the Billing Address that is on file for the cardholder's account. This attribute is only required if the "Require Billing Zip" field is enabled on the Security Settings page of the PayTrace Virtual Terminal. International Zipcodes require the country attribute.
billing_address.country string O C 2-digit ISO-3166-2 Country Code of the Billing Address that is on file for the cardholder's account. International Zipcodes require the this attribute.
shipping_address string O Supporting attributes listed below.
shipping_address.name string O Name of the person where the product is delivered.
shipping_address.street_address string O Address where the product is delivered.
shipping_address.street_address2 string O Second line of the address where the product is delivered.
shipping_address.city string O City where the product is delivered.
shipping_address.state string O State where the product is delivered.
shipping_address.zip string O Zipcode where the product is delivered
shipping_address.country string O 2-digit ISO-3166-2 Country Code of where the product is delivered.
email string O Customer's email address where the sales receipt may be sent.
invoice_id string R C Invoice is the identifier for this transaction in your accounting or inventory management system. This attribute is only required if the "Require Invoice" field is enabled on the Security Settings page of the PayTrace Virtual Terminal.
description string O Optional 255-character max text describing the transaction, products, customers, or other attributes of the transaction.
tax_amount string O Portion of the original transaction amount that is tax. Must be a number that reports the tax amount of the transaction. Use -1 if the transaction is tax exempt.
customer_reference_id string O Customer reference ID is only used for transactions that are identified as corporate or purchasing credit cards. The customer reference ID is an identifier that your customer may ask you to provide in order to reference the transaction to their credit card statement. Also known as a PO Number.