Skip to main content

Order Presentation

Once an order has been completed, the gift card information needs to reach the end customer. The recommended way to make this information available to the customer depends on your use case and how and where the customer will redeem the gift card.

Digital Delivery

For many use cases, the ordered gift card is redeemed online. In these cases, it is recommended to:

  • Send an email to the customer containing the code, redemption instructions, terms & conditions, and if available redemption notes. When using the email delivery method, finperks will take care of the delivery of the email to the customer. When using the delivery methods code or url, it is still recommended for you to provide an email to the customer with the code and instructions.
  • Display the code in your platform — make the order details and codes accessible through the online platform or mobile app where the customer made the purchase. This allows the customer to retrieve the code at any time.

In-Store Redemption

Some gift cards can also be redeemed at physical retail locations. For example, a gift card for a grocery store would likely be used in-store. Some brands offer both online and in-store redemption options.

When a customer needs to redeem a gift card in a physical store, reliable access to the code is critical — mobile network connectivity may not always be available. To address this, several options exist:

PDF Vouchers

Many brands provide a downloadable PDF version of the gift card that customers can print out or save for offline access. When available, the PDF download URL is included in the order response under the urls array with the type card_pdf.

Apple Wallet and Google Wallet Passes

For supported products, the order response includes URLs for Apple Wallet and Google Wallet passes. These allow customers to add the gift card directly to their mobile wallet for quick and convenient access — even without an active internet connection.

The wallet pass URLs are returned in the urls array of the order response with the types apple_wallet_pass and google_wallet_pass.

When providing the wallet pass URLs to customers, it is important to follow the guidelines provided by Apple and Google for each platform:

Availability

Wallet passes and PDF vouchers are not available for every product. Their availability depends on the brand and product configuration. When these options are supported, the corresponding URL entries will be present in the urls array of the completed order response. If they are not available, the entries will simply not be included.