Defines credit card, retail swipe, encrypted track data, and processor-specific transaction fields for Remote API processing.

Credit Card Transaction Fields

Use the fields below when processing credit card transactions through the Remote API authorization interface.

Variable Requirement Type Max Size Possible Values / Example Description Notes
card-number Mandatory string 16 4111111111111111 Credit card account number. Numeric characters only. See Credit Card Storage Validation Policy.
card-exp Mandatory string 5 12/28 Credit card expiration date. Format must be MM/YY.
card-cvv Optional / Fraud string 4 123 Card Verification Value (CVV/CVV2/CVC). May be required when fraud protection services are enabled.
commcardtype Optional string 8 business Indicates the transaction uses a business or commercial card. Supported value: business.
magstripe Optional string N/A %B411111111...0000000000? Raw magnetic stripe track data from a non-encrypted card reader. Required for retail/swipe transactions. Data must remain complete and unaltered, including start and end sentinels.
magensacc Optional string N/A — Encrypted magnetic stripe track data from an encrypted card reader. Required for retail/swipe transactions using encrypted readers. If multiple encrypted values are returned, use the supplemental encrypted track fields below.
devicesn Optional string N/A 1234567890 Device serial number of the encrypted card reader. Used for encrypted retail transaction processing.
KSN Optional string N/A FFFF9876543210E00008 DUKPT Key Serial Number associated with the encrypted swipe device. Required for certain encrypted device integrations.
Track1 Optional string N/A — Masked Track 1 card data. Used with encrypted card reader integrations.
EncTrak1 Optional string N/A — Encrypted Track 1 data. Used for encrypted retail transaction processing.
EncTrak2 Optional string N/A — Encrypted Track 2 data. Used for encrypted retail transaction processing.
EncTrak3 Optional string N/A — Encrypted Track 3 data. Used when available from supported devices.
EncMP Optional string N/A — Encrypted MagnePrint data. Used for device fingerprint and card authentication validation.
MPStatus Optional string N/A — MagnePrint processing status value. Returned or supplied by supported swipe devices.
swipedevice Optional string N/A ipad, ipad2, idtechkybrd Identifies the swipe device type. Only set when directed by gateway support staff.
marketdata Optional string 22 SUBFIELDXDATA Merchant-generated processor-specific data. Sometimes referred to as Sub Field X. Supported only by select processors.
cardissuenum Optional string 2 01 Card issue number associated with Maestro, Solo, or Switch cards. Required only for supported international card types.
cardstartdate Optional string 30 01/22 Card start date associated with Maestro, Solo, or Switch cards. Required only for supported international card types.
descrcodes Optional string 16 PLCODE01 Description codes used for FDR Omaha private label card processing. Applicable only to supported private label programs.
retailterms Optional string 4 TERM Retail terms value used for FDR Omaha private label transactions. Applicable only to supported private label programs.

Notes

The fields above support standard credit card processing, retail swipe transactions, encrypted card reader integrations, and processor-specific transaction requirements within the Plug’n Pay Remote API authorization interface.