Skip to main content
Order Protection integrates with Rise.ai to automatically issue gift cards to customers when their claims are approved, providing a seamless resolution experience.

​
Overview

The Rise.ai integration allows you to automatically create and manage gift cards for customers. Order Protection uses Rise.ai for:
  • Claim Resolution: Automatically issue gift cards when claims are approved
  • Bonus Store Credit: Issue store credit as customer rewards or incentives
  • Balance Updates: Add additional amounts to existing customer loyalty cards
When a claim is approved and resolved via gift card, or when bonus credit is issued, Order Protection automatically creates or updates a Rise.ai gift card and sends it to the customer.

​
Prerequisites

Before setting up the Rise.ai integration, ensure you have:
  • An active Rise.ai account
  • Your Rise.ai Credit API Token
  • Your store configured in Order Protection

​
Installation

Follow these steps to connect Order Protection with Rise.ai.
1

Get Your Credit API Token

Log in to your Rise.ai account and navigate to your settings to retrieve your Credit API Token. If you don’t see this option, reach out to your Rise.ai customer support contact.
The Credit API Token is different from other API keys - make sure you’re using the Credit API Token specifically.
2

Navigate to Integrations

In your Order Protection dashboard, go to Settings > Integrations and find Rise.ai in the list of available integrations.
3

Enter Your API Token

Click on the Rise.ai integration card and enter your Credit API Token in the field provided.The Credit API Token allows Order Protection to:
  • Create gift cards on your behalf
  • Attribute claim resolution gift cards to customer accounts
  • Track gift card balances and usage

Save Configuration

Click Save to complete the integration setup.Your Rise.ai integration is now active and ready to automatically issue gift cards for approved claims.

​
How It Works

Once the integration is configured, the gift card process is fully automated:

​
Creating New Gift Cards

For Claims:
  1. Claim Approval: When a support agent approves a claim and selects gift card as the resolution method
  2. Gift Card Creation: Order Protection automatically creates a gift card in Rise.ai with:
    • The claim amount as the gift card value
    • Customer’s email address and name
    • Reference to the original order number
    • Reference to the claim ID for tracking
    • Email subject: “Gift Card for Claim #[ClaimID]”
  3. Customer Notification: Rise.ai sends the gift card to the customer’s email with a customized message
  4. Gift Card Activation: The customer receives a gift card code they can use immediately
For Bonus Store Credit:
  1. Credit Issuance: When bonus store credit is triggered (e.g., loyalty rewards, promotions)
  2. Gift Card Creation: Order Protection creates a gift card with:
    • The specified credit amount
    • Customer’s email address and name
    • Reference to the original order number
    • Email subject: “Bonus Store Credit for Order #[OrderNumber]”
  3. Customer Notification: Rise.ai sends the bonus credit to the customer

​
Updating Existing Gift Cards

For customers with existing Rise.ai loyalty cards:
  1. Balance Check: Order Protection can retrieve the customer’s current gift card balance
  2. Balance Update: When additional credit is needed, Order Protection adds the amount to the existing card
  3. Type Tracking: Updates are marked as type “refund” with order reference for accounting
Gift cards are automatically associated with customer accounts using their customer ID, making it easy for returning customers to access and accumulate their credit.

​
Gift Card Information

Each gift card created through this integration includes:
  • Gift Card Code: Unique code the customer uses at checkout
  • Initial Value: The claim or credit amount
  • Current Balance: Available credit (may differ from initial value after partial use)
  • Customer Details: Email, name, and customer ID (if available)
  • Order Reference: Links back to the original order
  • Claim Reference: Links back to the specific claim (for claim-based cards)
  • Expiration: Based on your Rise.ai settings (optional)
  • Store Domain: Associated with your specific store
  • Gift Card Type: Indicates the source (claim resolution, bonus credit, etc.)
  • Collections: Associated Rise.ai collections for organization

​
Additional Features

​
Customer Loyalty Cards

Order Protection can retrieve and update existing customer loyalty cards:
  • Retrieve Balance: Check a customer’s current gift card balance before processing
  • Accumulate Credit: Add amounts to existing cards instead of creating multiple cards
  • Customer History: Track all gift card activity linked to the customer account
This functionality is particularly useful for:
  • Customers with multiple approved claims
  • Loyalty program integration
  • Preventing duplicate gift cards for the same customer

​
Best Practices

Ensure your customers understand:
  • How to check their gift card balance
  • Where to find their gift card code
  • Any expiration dates or usage restrictions
  • How to apply the gift card at checkout
  • That multiple credits may be consolidated into a single loyalty card
Use Rise.ai’s dashboard to:
  • Monitor gift card usage rates
  • Track outstanding gift card balances
  • Identify customers who haven’t redeemed their cards
  • Analyze gift card performance over time
  • Review balance update history for customer accounts
Consider using bonus store credit for:
  • Customer retention campaigns
  • Loyalty program rewards
  • Referral incentives
  • Apology gestures for service issues
  • First-time customer promotions
Track the source and performance of different bonus credit campaigns to optimize your strategy.

​
Troubleshooting

If a gift card isn’t created automatically:
  • Verify your Credit API Token is correct and active
  • Ensure your store domain is properly configured
  • Check that the customer has a valid email address
  • Verify the claim amount is greater than zero
If issues persist, check the integration status in your settings or contact Order Protection support.
If a customer reports not receiving their gift card:
  1. Check the customer’s spam/junk folder
  2. Verify the email address in the claim is correct
  3. Look up the gift card in your Rise.ai dashboard
  4. Manually resend the gift card from Rise.ai if needed
If you see an “API key not found” error:
  • Confirm you’re using the Credit API Token (not a different API key)
  • Check that the token hasn’t expired or been revoked
  • Re-enter the token in Order Protection settings
  • Contact Rise.ai support if the token appears invalid
If you see a “Store domain not found” error:
  • Verify your store is properly configured in Order Protection
  • Check that your store domain matches your Shopify store URL
  • Ensure the store hasn’t been archived or deactivated
  • Contact Order Protection support for assistance
If updating an existing gift card balance fails:
  • Verify the gift card ID exists in your Rise.ai dashboard
  • Check that the gift card hasn’t expired
  • Ensure the customer ID is correctly linked
  • Verify the additional amount is a valid positive number
  • Contact Rise.ai if the card appears to be locked or restricted
If you see a “Rise.ai service temporarily unavailable” error:
  • This is typically a transient outage on Rise.ai’s side
  • The system will automatically retry in most cases
  • Check Rise.ai’s status page for known issues
  • If the issue persists beyond 15 minutes, contact Rise.ai support

​
API Details

For developers and technical teams, the integration uses the Rise.ai Credit API v2 with the following endpoints:

​
Create Gift Card

Endpoint: POST /v2/gift-cards/issue/ Parameters:
  • shop_url: Your store domain
  • gift_card.balance: Gift card amount
  • gift_card.note: Internal note with claim/order reference
  • email_details.recipient: Customer name
  • email_details.recipient_email: Customer email
  • email_details.title: “Created by Order Protection”
  • email_details.subject: Customized subject line
  • email_details.body: Customized email body
Authentication: Uses x-rise-access-token header with your Credit API Token

​
Get Customer Gift Card

Endpoint: GET /v2/gift-cards/ Parameters:
  • shop_url: Your store domain
  • customer_id: Shopify customer ID
Returns:
  • gift_card_id: Unique identifier for the loyalty card
  • amount: Current balance
  • code: Gift card code
  • expires_on: Expiration date (if applicable)

​
Update Gift Card Balance

Endpoint: PUT /v2/gift-cards/{giftCardId} Parameters:
  • shop_url: Your store domain
  • amount: Additional amount to add
  • type: “refund” (for tracking purposes)
  • order_id: Reference order ID
Configuration:
  • Base URL: https://application.rise-ai.com (configurable via RISE_API_BASE_URL environment variable)
  • Integration Category: “Support”
The integration is category-tagged as “Support” in Order Protection, making it easy to find among support-related integrations.

​
Support

If you need assistance with the Rise.ai integration:
  • Order Protection Support: Contact our support team through your dashboard
  • Rise.ai Support: Reach out to your Rise.ai customer support contact
  • API Issues: Check your API token and store configuration first

Claims API

Learn how to create claims programmatically

Webhooks

Set up webhooks for claim approval events