cp_int_pos_paybutton_loyalty_bonus_cards

Welcome to the Developer Portal

Default UI Integration
- Integrating Default UI
- Migrating from PayButton to Default UI
- Managing Default UI Properties
- Summary Screen
- Incremental Authorization
- Custom Receipt Printing
- Automatic Receipt Printing
- Standalone Receipt Printing
- Sending Receipts via Email
- Customization
- Mobile UI Customization
- Release Notes

PayButton Integration
- Integration
- Stripe Transactions
- Alipay
- Summary Screen
- On-Reader Tipping
- Tip Adjust
- Loyalty and Bonus Cards
- Pre-Auth and Capture
- Refunds
- Custom Receipts
- Testing
- Going Live
- Release Notes

Custom Integration
- Installation
- Integration
- Stripe Transactions
- Signature
- Refunds
- Email & Print Receipts
- Custom Receipts
- Custom Receipts for PAX Terminals
- Preformatted Receipts
- Alipay
- On-Reader Tipping
- Tip Adjust
- Loyalty & Bonus Cards
- Pre-Auth & Capture
- Connection Keep-Alive
- Testing
- Going Live

Backend Integration
- API Endpoints and Authentication
- WebHooks
- Query Transactions
- Refunds
- Custom Receipts
- Going Live
- API Documentation

Card Readers
- Protecting Cardholder Data
- Developer Kits
- Test Cards
- Manage Card Readers
- Verifone Card Readers
  - Verifone e355
    - USB Connectivity Configuration
    - WiFI Connectivity Configuration
    - Windows Setup
    - User Guide
    - FAQ
  - Verifone P400
    - Getting Started with the Verifone P400
    - Ordering Test Equipment
    - Inspecting the Terminal
    - Connecting Verifone P400 Terminal Hardware
    - Configuring Ethernet Connectivity
    - Configuring USB Connectivity
    - Finding the Network Address Assigned to the Terminal
    - Configuring the Static IP Address
    - Verifying the Terminal IP Address
    - Changing Your Password on the Terminal
    - Processing a Transaction
    - Troubleshooting Terminal Issues
  - Verifone VX820
    - USB Connectivity Configuration
    - Ethernet Connectivity Configuration
    - Windows Setup
    - User Guide
    - FAQ
- Miura Card Readers
  - USB Connectivity Configuration
  - Windows Setup
  - Customization
  - Troubleshooting

Merchant Setup
- AMEX Merchant Setup
- Barclaycard APACS Merchant Setup
- Barclaycard HISO Merchant Setup
- Credorax Merchant Setup
- Elavon Merchant Setup
- EVRY Merchant Setup
- net-m Privatbank Merchant Setup
- Nexi Merchant Setup
- Stripe Merchant Setup
  - Stripe Direct and Stripe Connect
  - Stripe Connect

Accepting Loyalty and Bonus Cards

IMPORTANT

The PayButton Integration (Android) is in maintenance mode. For Android integrations, please use the new Default UI Integration SDK.

In addition to processing transactions with payment cards such as Visa and Mastercard, we also make it easy for you to read the card number (PAN) from magstripe-based Loyalty or Bonus Cards. Contact your account manager to determine if this feature will work with your specific loyalty or bonus card scheme. Currently only Miura card readers can read Loyalty or Bonus Cards.

In order to ensure the highest security standards, understand that you never will be able to read the PAN of a payment card. Instead, the BIN (i.e. the first six digits) of your loyalty or bonus card scheme must specifically be white-listed by us and never overlap with the BINs used by payment cards.

Reading a Magstripe Loyalty or Bonus Card

To read a magstripe loyalty or bonus card, create the activity via

createReadCardIntent

and check for

RESULT_CODE_READ_CARD_SUCCESS

onActivityResult

. After a successful swipe,

CardDetails

will contain the unencrypted

cardNumber

and raw

track1

track2

and

track3

data.

void readCard() {
        MposUi ui = MposUi.initialize(/* ... */);

        AccessoryParameters accessoryParameters = new AccessoryParameters.Builder(AccessoryFamily.MIURA_MPI)
                        .bluetooth()
                        .build();
        ui.getConfiguration().setTerminalParameters(accessoryParameters);

        Intent intent = MposUi.getInitializedInstance().createReadCardIntent();
        startActivityForResult(intent, MposUi.REQUEST_CODE_READ_CARD);
}

@Override
protected void onActivityResult(int requestCode, int resultCode, Intent data) {

        if (requestCode == MposUi.REQUEST_CODE_READ_CARD) {
                if (resultCode == MposUi.RESULT_CODE_READ_CARD_SUCCESS) {

                        CardDetails details = MposUi.getInitializedInstance().getCardDetails();

                        StringBuilder cardDetails = new StringBuilder();

                        if(details.getMaskedCardNumber() != null) {
                                cardDetails.append("MaskedCardNumber: " + details.getMaskedCardNumber() + "\n");
                        }

                        if(details.getCardNumber() != null) {
                                cardDetails.append("CardNumber: " + details.getCardNumber() + "\n");
                        }

                        if(details.getTrack1() != null) {
                                cardDetails.append("Track1: " + details.getTrack1() + "\n");
                        }

                        if(details.getTrack2() != null) {
                                cardDetails.append("Track2: " + details.getTrack2() + "\n");
                        }

                        if(details.getTrack3() != null) {
                                cardDetails.append("Track3: " + details.getTrack3() + "\n");
                        }

                        Toast.makeText(this, cardDetails.toString(), Toast.LENGTH_LONG).show();
                }
        }
}

PayButton Integration

Related information