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

# Stripe

> Process reimbursements and reconcile corporate card transactions with Stripe

## Overview

The Stripe integration enables expense reimbursement processing and corporate card transaction reconciliation. Pay employees directly via Stripe when expense reports are approved, and automatically match Stripe Issuing card transactions to expenses.

## Key Features

| Feature                      | Description                                                   |
| ---------------------------- | ------------------------------------------------------------- |
| **Reimbursement Processing** | Pay employees via ACH, wire, or Instant Payouts               |
| **Card Reconciliation**      | Auto-match Stripe Issuing transactions to expenses            |
| **Payment Tracking**         | Track reimbursement status in real-time                       |
| **Automatic Matching**       | Link Stripe charges to Smartbills expenses by amount and date |
| **Payout History**           | Full reimbursement history and audit trail                    |
| **Multi-currency**           | Process reimbursements in multiple currencies                 |

## Prerequisites

* Stripe account (with Stripe Connect or Issuing if applicable)
* Smartbills Business plan or higher
* Stripe account admin access

## Setup

<Steps>
  <Step title="Open the Apps Marketplace">
    In Smartbills, go to **Settings > Apps** and search for **Stripe**.
  </Step>

  <Step title="Connect Your Account">
    Click **Connect** and sign in to your Stripe account. Authorize Smartbills to create payouts and read transactions.
  </Step>

  <Step title="Configure Payouts">
    Set default payout method (ACH, wire, or instant) and currency preferences.
  </Step>

  <Step title="Map Card Programs">
    If using Stripe Issuing, map card programs and cardholders to Smartbills employees.
  </Step>
</Steps>

## Configuration

### Payout Methods

| Method          | Speed             | Fees                   |
| --------------- | ----------------- | ---------------------- |
| ACH Transfer    | 3-5 business days | No additional fees     |
| Wire Transfer   | 1-2 business days | Fee per transfer       |
| Instant Payouts | Minutes           | Percentage fee applies |

### Automatic Reimbursement

Configure automatic reimbursement for approved reports:

1. Report is approved by manager
2. Smartbills initiates payout via Stripe
3. Employee receives funds in their linked bank account
4. Reimbursement status updates automatically in Smartbills

### Stripe Issuing (Corporate Cards)

If you use Stripe Issuing for corporate cards:

| Setting            | Description                                     |
| ------------------ | ----------------------------------------------- |
| Auto-import        | Transactions import automatically to Smartbills |
| Auto-match         | Match card transactions to uploaded receipts    |
| Cardholder mapping | Link cardholders to Smartbills employees        |
| Spending limits    | Enforce category-level spending controls        |

### Reimbursement Rules

| Rule               | Description                                            |
| ------------------ | ------------------------------------------------------ |
| Auto-pay threshold | Automatically process payouts below a set amount       |
| Approval required  | Require finance approval for payouts above threshold   |
| Batch payouts      | Group reimbursements into a single payout per employee |
| Payout schedule    | Process payouts daily, weekly, or on demand            |

## Data Sync

| Smartbills             | Stripe               | Direction            | Frequency           |
| ---------------------- | -------------------- | -------------------- | ------------------- |
| Reimbursement requests | Payouts              | Smartbills -> Stripe | On approval         |
| Payout status          | Payout events        | Stripe -> Smartbills | Real-time (webhook) |
| Card transactions      | Issuing transactions | Stripe -> Smartbills | Real-time (webhook) |
| Employee bank info     | Connected accounts   | Stripe -> Smartbills | On demand           |

## Troubleshooting

<AccordionGroup>
  <Accordion title="Payout failed">
    Check the error details in **Settings > Apps > Stripe > Payout History**. Common causes include insufficient Stripe balance, invalid bank account, or compliance holds.
  </Accordion>

  <Accordion title="Card transactions not importing">
    Verify that Stripe Issuing webhooks are configured. Check the webhook endpoint status in your Stripe Dashboard.
  </Accordion>

  <Accordion title="Connection expired">
    Stripe OAuth connections may need re-authorization. Click **Reconnect** in the integration settings.
  </Accordion>

  <Accordion title="Currency not supported">
    Verify the payout currency is enabled in your Stripe account settings. Stripe supports payouts in the settlement currencies configured on your account.
  </Accordion>

  <Accordion title="Duplicate payouts">
    Check the payout history for duplicate entries. Disable automatic reimbursement if you are also processing payouts manually.
  </Accordion>
</AccordionGroup>