Collect swiped dataPrivate preview

Available in:

• All supported countries for BBPOS Chipper2X BT and Stripe M2 using Android SDK and iOS SDK 3.7.0 and up
• All supported countries for Stripe Reader S700 and BBPOS WisePOS E on reader software version 2.28.3.0 and up using Android SDK, Apps on Devices, and iOS SDK 4.2.0 and up

Use the Terminal SDK to read non-PCI payment instruments, such as gift cards, using the reader’s hardware interfaces like the magnetic stripe reader. This feature isn’t available offline.

After swiping the card, the Terminal SDK provides a tokenized data object. Securely retrieve the cleartext track data on your backend with the token.

The Terminal reader only reads and stores cleartext magstripe data that follows these formats:

• The card data is available on track 2 only.
• The card data uses only the ISO/IEC-7813 track 2 start sentinel ; and end sentinel ?, without the separator character.
• The card data consists only of numeric digits.

Contact the Terminal team with your card format and BIN ranges if your card numbers don’t match one of these approved formats.

import UIKit
import StripeTerminal

class PaymentViewController: UIViewController {
    func readGiftCard() throws {
        let config = try CollectDataConfigurationBuilder().setCollectDataType(.magstripe).build()
        self.cancelable = Terminal.shared.collectData(config) { collectedData, collectError in
            if let error = collectError {
                // Handle read errors
                print("Collect data failed: \(error)")
            } else if let data = collectedData, let stripeId = data.stripeId {
                print("Received collected data token: \(stripeId)")
            }
        }
    }
}

curl https://api.stripe.com/v1/terminal/reader_collected_data/tmrcd_xxxxxxxx \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:"