Gift Cards

POS Integration / Core Concepts

Gift Cards

Implementing LevelUp gift cards is an easy way to add even more value to the merchants and consumers using your integration or application. If you simply wish to accept LevelUp-powered gift cards (and you already accept LevelUp orders), there is no additional work to be done as LevelUp payments via gift cards work just like any other LevelUp payment. However, if you’d like to allow your clients to sell gift cards, you’ll need to implement the endpoints below.

Loading Gift Cards

To load a LevelUp gift card, simply create a request to the add gift card value endpoint. An approved response will be returned alongside the old and new values on the card.

If the gift card is being paid for with LevelUp, the amount of the gift card must be included in the exemption_amount param of the order creation call. This will block the user from redeeming or earning loyalty rewards or progess on the transaction.

NOTE: When loading value onto a LevelUp gift card, make sure you do not actually load value to the card until the payment for the value is tendered through the system, otherwise there is a high potential for fraud.

Checking Gift Card Values

Current gift card values can be retrieved from the merchant-funded gift card credit endpoint.

Make sure you apply LevelUp gift card credit as a tender (“LevelUp Gift Card Tender”) and not as a discount.

Redeeming Gift Cards

Redeeming LevelUp gift cards is simple - all you need to do is a standard LevelUp order, but use the gift card QR code in place of the customer’s standard QR code. In some cases, the customer will have loaded the gift card directly onto their account, so there is no difference at all!

Destroying Gift Card Value

If you ever need to remove value from a gift card (to refund a gift card or to correct cashier error), use the destroy value endpoint.

NOTE: Do NOT use this endpoint to “redeem” gift card value. This endpoint is only to be used to correct errors.