BHN

Overview

With the Extole and BHN integration, you can drive customer acquisition, generate brand advocacy, and build long-term loyalty with your customers. This powerful integration automates reward fulfillment with real-time reward delivery and offers a wide variety of reward options from Virtual Prepaid Cards to Physical Reloadable Cards for your referral and engagement programs.

Prerequisites

Requirement	Description
Blackhawk Network Incentives Customer	You must be a Blackhawk Network Incentives customer in order to leverage this integration.
Enterprise Hawk Marketplace Account	You must have an Enterprise Hawk Marketplace account in order to leverage this integration.
BHN Merchant ID	The unique identifier associated with your BHN account.
BHN Client Program Number	The unique identifier associated with your BHN program.
BHN Payment Method	The method you will use to fund your BHN program. Options include ACH and Draw Down.
BHN Pre-Production and Production Certificates	The certificates needed to generate your Client Key ID for your staging and production integrations. Your Extole team will request the certificates from your BHN team.
Extole Webhook IP Address	The IP address that needs to be included in any outbound webhook requests sent from Extole to BHN. Extole will provide the webhook IP address to your BHN team.

Available Products

Virtual Cards

Virtual Prepaid Cards are a great contactless payment option when you need something fast. They can be used for online and phone purchases anywhere Debit Mastercard and Visa Debit Cards are accepted.Virtual Prepaid Mastercard cards can also be added to popular mobile wallets like Apple Pay, Samsung Pay, and Google Pay.

Physical Reloadable Cards

Reloadable prepaid cards are ideal for companies who want to reward their recipients multiple times throughout the year. They can be used to incentivize program participation by creating cards specific to certain categories, like health and wellness. Additionally, they can be personalized with a company logo and a recognition message to strengthen relationships.

Learn more about BHN rewards.

Integration

Complete the following steps to quickly get your integration up and running. Your Extole and BHN teams will support you through this process and answer any questions you may have.

Enable the BHN Integration

Your Extole team will help you with this process.

Select the BHN integration on the Partners center of your My Extole account.
Within the BHN integration, hit the Install button to initiate the connection between Extole and BNH.
Several required fields will appear where you'll need to provide information such as the Merchant ID and Client Key ID. Your Merchant ID is a unique identifier, provided by your BHN team, that identifies your business within their system. The Client Key ID will be configured by your Extole team.
Complete the connection by applying the changes.

Set up the BHN Reward Supplier from your Rewards page

Go to Rewards page in your My Extole account and hit + New Reward.
Select the Reward Type—Virtual Card or Physical Card.
Specify the name of the reward, the value of the reward, and the Client Program Number supplied by your BHN team. You can also get your program number from the Hawk Marketplace Portal.
Select the appropriate Payment Type. Confirm your preferred payment method (ACH Debit or Drawdown) and complete the necessary documentation for setup. This step can be confirmed with your BHN team.
Save the configuration and use the newly created reward.

Once the integration is complete, you will be able to see rewards flow in real-time in your My Extole account.

FAQs

How can I understand the status of a reward in the Extole platform?

Extole leverages HTTP status codes from BHN API responses to update the status of a card order (aka reward) in the Extole platform. You can use the Extole platform to understand if a reward has been submitted to BHN, if it's been processed and sent to the recipient, or if the reward failed. Refer to the table below for additional information on reward stages in the Extole platform.

Refer to BHN's Developer Documentation for more detailed information on card ordering and response codes for physical prepaid cards, re-loadable cards, and digital prepaid cards.

Reward State in Extole	Definition
`EARNED`	Extole has submitted a card order to BHN and is waiting on confirmation from BHN whether the order has been processed or has failed.
`TRYING TO FULFILL`	BHN has responded to Extole's order request and is processing the card order. -Physical Prepaid Single Load cards take up to 2-3 business days to process. -Physical Prepaid Re-Loadable Cards take up to 2-3 business days to process the initial card order, and then 24 hours for any subsequent re-loads. -Digital Prepaid Single Load Cards take up to 24 hours to process.
`SENT`/ `FULFILLED`	BHN has successfully processed the order and has sent the card to the recipient via email/post. Physical cards take an additional 7-10 business days to arrive in the mail.
`FAILED`	BHN was not able to process the order, either due to an improperly formatted request (400), a duplicate request ID (409), or a system error (500). Extole's monitoring system will automatically detect failures and triage them into tickets for resolution via the Extole support team. In the case of a 409 (duplicate request ID), Extole Support may re-send the request to BHN with an updated request ID. In the case of a 400 or 500, Extole will reach out to the BHN account manager to cancel the reward and then submit a new order to BHN for processing.
`CANCELED`	An order has been canceled inside of the Extole platform. This is a manual operation done by the Extole customer support team. Any order canceled in the Extole platform also needs to be escalated to the BHN Acccount Manager for cancellation in Hawk Marketplace.