> ## Documentation Index
> Fetch the complete documentation index at: https://docs.mention-me.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Runa

> Set up the Runa voucher integration to issue gift card rewards through your referral programme.

## About the integration

Integrating with Runa lets you choose from a selection of standard gift cards or create your own, which are then passed to the Mention Me platform as referral rewards.

To proceed, you need to:

1. Create Runa API Keys and save them in the Mention Me platform
2. Provide voucher Product Codes to Mention Me (either as a Payout Link Template ID or a Single Product Code)
3. Optionally provide a User Redemption Template if required

Contact your Mention Me onboarding project manager or CSM with any questions.

## Step 1 — Create API Key in Runa

<Steps>
  <Step title="Log in to Runa">
    [Log in](https://app.runa.io/) to Runa with an account that has permissions to create API Keys.
  </Step>

  <Step title="Navigate to API Key creation">
    Navigate to **API > Create API Key**. [Learn more about creating API keys](https://developer.runa.io/docs/getting-an-api-key).

    <img src="https://mintcdn.com/mentionme/DW6A4iNCa7LrbN3W/images/knowledge/integrations/reviews-rewards/18467165364893.png?fit=max&auto=format&n=DW6A4iNCa7LrbN3W&q=85&s=af79ea605182a28c1678979a949dd587" alt="Runa API Key creation page" width="3008" height="1182" data-path="images/knowledge/integrations/reviews-rewards/18467165364893.png" />
  </Step>

  <Step title="Select Production Key">
    Select **Production Key**.
  </Step>

  <Step title="Create the key">
    Enter a name for the key (e.g. `Mention_Me`) and press **Create Key**.

    <Warning>Save the credentials immediately — you will only see them once.</Warning>
  </Step>
</Steps>

## Step 2 — Save Runa API Key in Mention Me

<Steps>
  <Step title="Add Runa as a provider">
    Go to the [Mention Me platform](https://mention-me.com/merchant/~/reward-providers) and click **Set-up new 3rd Party Provider**. Select **Runa**.

    <img src="https://mintcdn.com/mentionme/DW6A4iNCa7LrbN3W/images/knowledge/integrations/reviews-rewards/18467781723293.png?fit=max&auto=format&n=DW6A4iNCa7LrbN3W&q=85&s=d17afbc890011eb5fda9e3302e52a6b2" alt="Set-up new 3rd Party Provider dialog with Runa selected" width="1110" height="842" data-path="images/knowledge/integrations/reviews-rewards/18467781723293.png" />
  </Step>

  <Step title="Enter API Key">
    Enter a name and paste the **API Key** from Step 1. Click **Create**.

    <img src="https://mintcdn.com/mentionme/DW6A4iNCa7LrbN3W/images/knowledge/integrations/reviews-rewards/18467750736797.png?fit=max&auto=format&n=DW6A4iNCa7LrbN3W&q=85&s=434fc71f3b2dd8d631e93a608b325317" alt="Runa API Key entry form in Mention Me" width="1558" height="944" data-path="images/knowledge/integrations/reviews-rewards/18467750736797.png" />
  </Step>
</Steps>

## Step 3 — Share Runa Product Codes

Based on your campaign setup, you can use either a single product order or a payout link.

Email these codes to Mention Me Support, your CSM, or Onboarding Project Manager.

### Single Product Orders

Identify and copy the product code of the specific voucher to be issued, then send to Mention Me.

<img src="https://mintcdn.com/mentionme/DW6A4iNCa7LrbN3W/images/knowledge/integrations/reviews-rewards/18467134441629.png?fit=max&auto=format&n=DW6A4iNCa7LrbN3W&q=85&s=f33ecd000334f2f4896a5283578733cc" alt="Runa product catalogue showing voucher product codes" width="2416" height="654" data-path="images/knowledge/integrations/reviews-rewards/18467134441629.png" />

### Payout Links

<Steps>
  <Step title="Create a payout template">
    Create a payout template by following [these instructions](https://runapay.zendesk.com/hc/en-gb/articles/16748251131037-How-to-create-payout-selection-templates).
  </Step>

  <Step title="Share the Template ID">
    Copy the **Template ID** (begins with `PT`) and send it to Mention Me.

    <img src="https://mintcdn.com/mentionme/DW6A4iNCa7LrbN3W/images/knowledge/integrations/reviews-rewards/18467165374493.png?fit=max&auto=format&n=DW6A4iNCa7LrbN3W&q=85&s=cfda4fa2c54133a285db8fc8dd0e4514" alt="Runa payout template with Template ID" width="1298" height="1254" data-path="images/knowledge/integrations/reviews-rewards/18467165374493.png" />
  </Step>
</Steps>

## Step 4 — Share Runa User Redemption Template ID (optional)

If using a custom redemption page:

<Steps>
  <Step title="Create a redemption template">
    Follow [these steps](https://runapay.zendesk.com/hc/en-gb/articles/16748212211101-How-to-create-redemption-templates) to create a redemption template.
  </Step>

  <Step title="Share the Template ID">
    Copy the **Template ID** (starts with `DT`) and share with Mention Me.

    <img src="https://mintcdn.com/mentionme/DW6A4iNCa7LrbN3W/images/knowledge/integrations/reviews-rewards/16961687634589.png?fit=max&auto=format&n=DW6A4iNCa7LrbN3W&q=85&s=ff69cdee4ba89f061f4626a8610fb4ec" alt="Runa user redemption template with Template ID" width="3002" height="1530" data-path="images/knowledge/integrations/reviews-rewards/16961687634589.png" />
  </Step>
</Steps>

Send this code to Mention Me Support, your CSM, or Onboarding Project Manager so they can configure your reward.