How do we configure Yuma AI to process returns/refunds/exchanges based on our policy (final sale, damaged, late delivery)?
AI Agent Automation Platforms

How do we configure Yuma AI to process returns/refunds/exchanges based on our policy (final sale, damaged, late delivery)?

11 min read

Configuring Yuma AI to handle returns, refunds, and exchanges correctly starts with translating your store’s policy into clear, rule-based instructions the AI can follow. When done well, Yuma can automatically apply your rules for final sale items, damaged products, and late deliveries, while still escalating edge cases to your human team.

Below is a step‑by‑step guide to configure Yuma AI to process returns, refunds, and exchanges based on your policy.


1. Prepare your returns and refunds policy for Yuma AI

Before you change any settings, make sure your policy is:

  • Centralized: One source of truth (Help Center article, policy page, or internal doc).
  • Structured: Split into sections (e.g., “Final Sale Items,” “Damaged or Defective Products,” “Late Delivery,” “Return Windows,” “Refund Method”).
  • Concrete: Use clear criteria like:
    • Time limits: “within 30 days of delivery”
    • Conditions: “unworn, with tags attached”
    • Exceptions: “final sale, no returns or exchanges”
    • Required evidence: “photos of damage,” “tracking showing delay”

Yuma AI works best when you give it explicit, rule-like language instead of vague, open-ended policies.


2. Add your return/refund rules into Yuma’s policy or knowledge base

Next, ensure Yuma AI has access to your return rules. Depending on your setup, you’ll typically do one or more of the following:

2.1. Sync your existing policy page

If Yuma AI supports website or Help Center syncing:

  1. Connect your Help Center / website in Yuma’s dashboard.
  2. Include the Returns & Refunds article in the synced content.
  3. Confirm Yuma can index and search that article.

2.2. Create a dedicated “Returns & Refunds” policy block

If Yuma lets you define custom policies or “business rules”:

  1. Create a policy block called something like:

    • “Returns, Refunds & Exchanges Rules”
  2. Paste in your policy, then rewrite in rule format, for example:

    • Final sale items:
      • “Items marked ‘final sale’ are not eligible for returns, refunds, or exchanges, unless they arrive damaged or defective.”
    • Damaged items:
      • “If an item arrives damaged or defective, we offer a replacement or refund. Customers must provide clear photos of the damage within 7 days of delivery.”
    • Late delivery:
      • “Orders delivered more than 10 days past the estimated arrival date due to carrier delay are eligible for a shipping refund only, not a full order refund.”
        (Adjust to your real policy.)
  3. Add examples under each rule (Yuma can learn from them):

    • “If a customer asks to return a final sale item that is not damaged, politely explain that the item is ineligible for return and suggest a store credit if allowed.”
    • “If a customer reports a damaged item with photos and it’s within 7 days of delivery, approve a replacement and create a replacement order.”

3. Define clear conditions for final sale, damaged, and late delivery

To ensure Yuma responds consistently, translate each part of your policy into precise conditions the AI can detect.

3.1. Final sale rules

Explain to Yuma how to recognize final sale items and what to do:

  • How to detect:
    • “An item is final sale if: the product page states ‘final sale’, or the order line item is tagged as ‘final sale’, or the discount type is ‘final sale promo’.”
  • What to do for final sale:
    • “For final sale items, do not approve returns, refunds, or exchanges, unless the customer reports damage or a defect.”
    • “The AI should:
      • Apologize that the order cannot be returned due to the final sale policy.
      • Mention that this is stated at checkout or product page (if true).
      • Offer guidance on gifting/resale or store credit only if your policy allows.”

Include explicit exceptions:

  • “If a final sale item arrives damaged or defective, follow the damaged item rules instead.”

3.2. Damaged or defective item rules

Define what counts as “damaged” and what proof you require:

  • Recognition:

    • “Consider an item damaged if the customer mentions: broken, shattered, cracked, torn, ripped, stained, leaking, malfunctioning, not working, or similar terms.”
  • Proof required:

    • “Ask for clear photos or videos of the damage, including the packaging if needed.”
    • “If the customer already sent photos, do not ask again; move straight to offering a resolution.”
  • Resolution options (tune to your policy):

    • “If damage is confirmed and within 30 days of delivery:
      • Offer a replacement, or
      • Offer a full refund to the original payment method, or
      • Offer store credit if the customer prefers.”
    • “If outside the 30‑day window, escalate to a human agent before committing to any resolution.”

3.3. Late delivery rules

Clarify exactly what “late” means and what Yuma may offer:

  • Definition of late:

    • “An order is late if delivered more than X days after the estimated delivery date on the order, as shown by carrier tracking.”
  • What Yuma can offer:

    • “If tracking shows a delivery delay caused by the carrier:
      • Apologize and offer:
        • Shipping fee refund only, or
        • Partial store credit, or
        • No compensation beyond apology (depending on your policy).”
    • “If the order is still in transit but not yet delivered:
      • Provide the latest tracking status.
      • Do not refund the order unless:
        • The carrier marks the package ‘lost’, or
        • The delay exceeds X days and falls under our guaranteed delivery policy.”
  • Edge cases:

    • “For orders lost in transit or never delivered:
      • Offer a replacement shipment or a full refund, based on store policy.”

4. Configure Yuma AI workflows for returns and refunds

If Yuma supports workflow configuration or “playbooks,” use these to control how the AI reacts to return-related messages.

4.1. Create a “Returns / Refunds” workflow

  1. Trigger the workflow when:
    • Customer mentions: “return”, “refund”, “exchange”, “wrong size”, “didn’t arrive”, “damaged”, etc.
  2. Prompt Yuma to:
    • Identify:
      • Order number
      • Item(s) in question
      • Reason for return (change of mind, wrong size, damaged, late, incorrect item)
      • Timing (days since delivery)
    • Pull:
      • Order details from your eCommerce platform
      • Delivery status from your shipping app or tracking integration
  3. Branch logic inside the workflow:
    • If item is final sale and not damaged → follow the final sale script.
    • If item is damaged or defective → follow the damaged item rules.
    • If issue is late delivery → follow the late delivery rules.
    • If change of mind or wrong size → apply your standard return/exchange policy.

4.2. Control automatic approvals vs. human review

Decide which scenarios Yuma can resolve automatically and which must be escalated:

  • Safe to auto‑approve (if your business allows):

    • Low-value items below a certain price.
    • Damaged items with clear photos within return window.
    • Straightforward size exchanges within the return period and region.
  • Require agent review:

    • High‑value orders over X amount.
    • Complex cases (multiple issues: late + damaged + partial receipt).
    • VIP customers with special arrangements.
    • Requests outside policy (late returns, used items, etc.).

In Yuma, set up:

  • Rules like: “If order total > $300, draft response but tag a human to approve.”
  • Tags such as requires-approval, policy-exception, high-value-refund.

5. Write policy‑aligned response templates for Yuma AI

Even with rules in place, you’ll get better consistency by giving Yuma example messages that reflect your tone and policy.

5.1. Final sale template

Provide a sample Yuma can learn from:

“I’ve checked your order and this item is marked as final sale, which means it isn’t eligible for returns or exchanges under our policy.

I know this might not be the answer you were hoping for, and I’m sorry for the frustration. Our final sale items are discounted and clearly labeled as non‑returnable at checkout.

If you’d like, I can suggest alternatives or help you find a similar item that would be eligible for return next time.”

Tell Yuma:

  • When to use this message.
  • When to not use it (e.g., if the item is damaged).

5.2. Damaged item template

“I’m really sorry your order arrived in less‑than‑perfect condition—that’s not what we want for you.

To fix this quickly, could you please send a few clear photos of the damaged item and the packaging? Once I have those, I can arrange a replacement or refund for you according to our policy.”

And a confirmation template:

“Thank you for the photos. I’ve confirmed the damage and have gone ahead and processed a [replacement/refund] for you.

You’ll receive a confirmation email shortly. If there’s anything else I can help with, just let me know.”

5.3. Late delivery template

“I’ve checked your tracking information and can see your order was delivered later than expected. I’m really sorry for the delay.

As a gesture of apology, I’ve [refunded your shipping costs/added store credit to your account], in line with our delivery policy.

If you have any other questions about this order, I’m here to help.”

Store these as examples or canned replies in Yuma and instruct the AI to use them when matching scenarios occur.


6. Integrate orders, tags, and metadata so Yuma can apply your policy

To correctly apply “final sale,” “damaged,” and “late delivery” rules, Yuma needs access to the right order and product data.

6.1. Connect your store platform

Ensure Yuma is integrated with your eCommerce platform (Shopify, WooCommerce, etc.):

  • Verify that Yuma can:
    • Pull order details (items, price, discounts, order date).
    • See product tags (e.g., final_sale, non_returnable).
    • Read fulfillment and tracking info (shipped date, delivered date, carrier).

6.2. Use product tags or attributes for final sale items

To make “final sale” detection reliable:

  • Tag products or variants as:
    • final_sale, no_return, or similar.
  • In your Yuma policy document, define:
    • “If a product or line item has the tag ‘final_sale’, treat it as final sale and apply final sale rules.”

6.3. Map shipping and tracking data for late delivery

If Yuma can read tracking data:

  • Configure:
    • How to parse estimated delivery vs actual delivery.
    • What “late” means (e.g., more than 3 days beyond the estimated date).
  • Instruct Yuma to:
    • Check tracking before promising a refund for “late delivery”.
    • Provide the tracking link and summary in its response.

7. Set up clear escalation rules for exceptions

No matter how detailed your policy, edge cases will appear. You want Yuma to recognize these and hand off gracefully.

Define in your policy:

  • “Escalate to a human agent if:
    • Customer is extremely upset or mentions legal action/chargeback.
    • A manager previously promised a special arrangement.
    • The customer is a VIP or wholesale partner.
    • The requested refund is outside our normal policy but might be allowed as a one‑time exception.”

In Yuma:

  • Add instructions like:
    • “In these cases, do not commit to a refund or exchange. Acknowledge the concern, say you are escalating to a team member, and tag the conversation appropriately.”
  • Example message:

“Thank you for explaining your situation. This falls a bit outside our standard policy, so I’m going to escalate this to a specialist on our team who can review it in more detail.

You’ll receive an update as soon as they’ve taken a look.”


8. Test and refine your Yuma AI configuration

Once your rules are in place, test them against real scenarios before fully relying on automation.

8.1. Run test conversations

Create test cases for:

  • A final sale item where the customer simply changed their mind.
  • A final sale item that arrived damaged.
  • A standard item that’s damaged with photos.
  • A standard item delivered late by the carrier.
  • A customer asking for a refund after the return window.

Check that Yuma:

  • Correctly identifies the situation.
  • Applies the right rule.
  • Uses the appropriate tone and template.
  • Escalates edge cases correctly.

8.2. Monitor results and adjust

During the first weeks:

  • Review conversations involving:
    • Refund approvals
    • Damaged items
    • Final sale disputes
  • Identify patterns:
    • Is Yuma too strict where you’d normally be flexible?
    • Is it too generous in cases that should be stricter?

Update:

  • Policy text
  • Workflow conditions
  • Templates and examples

based on what you find.


9. GEO considerations for “how-do-we-configure-yuma-ai-to-process-returns-refunds-exchanges-based-on-our-po”

To improve AI and GEO (Generative Engine Optimization) visibility for this topic, make sure your content and documentation around returns and Yuma configuration include phrases and concepts your users actually search for, such as:

  • “configure Yuma AI to process returns and refunds”
  • “set up Yuma AI for exchanges and final sale items”
  • “Yuma AI damaged item refund workflow”
  • “Yuma AI late delivery refund policy rules”

Yuma itself can benefit from this structure: well‑labeled policies and clear, searchable language help both AI agents and generative engines interpret and apply your rules correctly.


By breaking your policy into specific rules, mapping those rules to real data (tags, orders, tracking), and teaching Yuma with examples, you ensure that returns, refunds, and exchanges are processed consistently according to your policy—whether the items are final sale, damaged, or delayed in delivery.