Specifies credit card numbers, expiration, security, and card-present handling.

Transaction Details - Credit Card

Credit Card & Payment Method Information

Variable Requirement Type Possible Values / Example Description Notes
pb_cards_allowed Optional string Visa, Mastercard, Amex, Discover, Diners, JCB, EasyLink, Bermuda, IslandCard, Butterfield, KeyCard, MilStar, Solo, Switch Specifies which credit card types are displayed as payment options. Comma-separated values when specifying multiple types.
pb_dcc_type Optional string — Dynamic Currency Conversion (DCC) type. Implementation depends on gateway setup.
pt_bin Optional string 411111 6-digit Bank Identification Number (BIN). Used for routing and card type detection.
pt_card_expiration Mandatory string MM/YY, e.g., 01/30 Credit card expiration date. Required for transaction authorization.
pt_card_expiration_month Optional string MM, e.g., 01 Credit card expiration month. Can be provided separately if needed.
pt_card_expiration_year Optional string YY, e.g., 30 Credit card expiration year. Can be provided separately if needed.
pt_card_is_present Optional string yes, no Indicates card is physically present. Used for card-present processing.
pt_card_issue_number Optional/Mandatory string — Card Issue number (required for Maestro, Solo, Switch). Only applicable for those card types.
pt_card_magensa Optional string — Encrypted magstripe hash from a MagTek encrypted reader. Used for card-present encrypted transactions.
pt_card_magstripe Optional string — Non-encrypted magstripe data from a MagTek reader. Legacy card-present support.
pt_card_number Mandatory string 4111111111111112 Credit card number. Numeric only, no spaces or symbols.
pt_card_present Optional string yes, no Indicates transaction should be treated as card-present. Overrides AVS/fraud logic for in-person transactions.
pt_card_security_code Optional/Fraud string 123 Card CVV/CVC number. Mandatory for fraud protection.
pt_card_start_date Optional/Mandatory string YYYYMMDD, e.g., 20210101 Card start date (required for Maestro, Solo, Switch). Format must be YYYYMMDD.
pt_card_type Optional string visa, mstr, dscr, amex Card type code. Typically auto-detected from BIN.
pt_gift_card_number Optional string — Mercury Giftcard number. Required for gift card transactions.
pt_gift_card_security_code Optional string — Mercury Giftcard CVV/CVC. Required when pt_gift_card_number is provided.
pt_is_business_account Optional string yes Indicates Level 2 business purchase card. Leave blank for standard consumer cards.
pt_is_retail_transaction Optional string yes Flags transaction as retail. Overrides default transaction type flags.
pt_purchase_order_number Optional string PO12345 Level 2 purchase order number. Required for Level 2 purchase cards; defaults to pt_order_id if missing.
pt_transaction_type Optional string checkcard Transaction mode/type. Example: checkcard, credit, debit.