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.

For some products the displayed code should link to a specific URL rather than being shown as a plain code. When this applies, the order response includes a URL in the urls array with the type code_link.

When a code_link URL is present, render the code as a hyperlink pointing to that URL (for example <a href="https://brand.example.com/...">CODE</a>) instead of showing the code on its own. Unlike the other urls entries — which are presented as separate actions such as a wallet button or a PDF download — the code_link URL is not a standalone link: it is the destination the code itself should point to.

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.