How to Enroll a Card

A key component of running your Olive-powered programs is enrolling members’ credit cards.

In This Article

  1. Enroll a Card
    1. Integration Status
    2. Error Codes
  2. Unenroll a Card
    1. Use Cases for Unenrolling a Card
    2. Things to Consider

Enroll a Card

Enrolling a member’s credit card is an important part of running a successful rounding and/or loyalty program. This enables Olive to receive transactions on the member’s card from their respective card network (E.g., Visa, Mastercard).

To enroll a card, you can:

See our technical guide, Enroll Your Customer in Olive Programs, for more information. 

Once a card is enrolled, Olive will receive all qualifying transactions on that card and use them to facilitate the program(s) that the member is in. 

Integration Status

All enrolled cards will have an integration status that indicates whether they’re enrolled on the card network side for transaction monitoring. See The Card Object for more details on integration status.

Error Codes

In rare cases, you may encounter an error when enrolling a card. See Error Scenarios for more details on these cases. If you need further assistance, reach out to your account manager or support@oliveltd.com.

Unenroll a Card

In some cases, you may need to unenroll a card for a member. To unenroll a card, you can:

  • Call the Deactivate a Card endpoint using the desired cardId, or
  • Find the card in the Customer Portal to deactivate it (see: Cards)

When a card is unenrolled, any subsequent transactions on that card will not be tracked until the card is re-enrolled.

Use Cases for Unenrolling a Card

  • During integration, your technical team may want to conduct tests that require unenrollment
  • Post-launch, a member may need to unenroll a card for various reasons (E.g., lost/stolen card, closed account, etc.)

Things to Consider

If a card is…

Then…

Unenrolled and then re-enrolled under the same member,

It will be treated as the same card with all historical data associated with it.

Unenrolled and then re-enrolled under a new member,

A new cardId will be generated, and any historical data will not be associated with the new card.

Still active when re-enrollment is attempted,

The card will not be enrolled again. Olive will return an error message “Card finger-print already in use.”