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

# Settlements

> Understand the Axra Pay settlement lifecycle, fee deductions, and timeline for when captured payments are credited to your Axra merchant wallet.

Settlement is the process by which funds from a captured payment move through the card networks and land in your Axra merchant wallet, where they become available for withdrawal. The process is not instantaneous — after a payment is captured, the funds spend time in transit through card network clearing before Axra can credit them to your account. Understanding the settlement flow helps you accurately forecast cash flow and identify any delays.

## Settlement flow

<Steps>
  <Step title="Payment captured">
    The customer's card is charged successfully. Axra fires a `payment.completed` webhook event. The payment's `settlementStatus` is set to `PENDING_SETTLEMENT`.
  </Step>

  <Step title="Funds in transit">
    The captured funds move through card network clearing. This typically takes **2–3 business days**. Weekends are excluded from this count. Your specific timeline may vary based on your merchant risk category and the terms in your merchant agreement.
  </Step>

  <Step title="Funds settled">
    Once clearing completes, Axra deducts platform fees and credits the net amount to your merchant wallet. The payment's `settlementStatus` updates to `SETTLED`, and Axra fires a `payment.settled` webhook event.
  </Step>
</Steps>

## Settlement statuses

| Status               | Description                                                       |
| -------------------- | ----------------------------------------------------------------- |
| `PENDING_SETTLEMENT` | Payment captured, awaiting fund clearance through card networks   |
| `SETTLED`            | Funds cleared and credited to your merchant wallet                |
| `SETTLEMENT_FAILED`  | Settlement failed — Axra operations team is automatically alerted |

<Note>
  If settlement is not confirmed within the expected window, Axra runs an auto-settlement process hourly as a safety net to ensure your funds are credited without manual intervention.
</Note>

## Fee deductions at settlement

When a payment settles, Axra deducts platform fees before crediting your wallet. The net amount you receive is the captured payment amount minus the percentage rate fee and a flat per-transaction fee.

```
Settlement Amount:     $100.00
Platform Fee (3.9%):   -  3.90
Flat Transaction Fee:  -  1.00
                       --------
Merchant Net:          $ 95.10
```

Your fee rate depends on your merchant tier:

| Tier        | Rate   | Applies when                                      |
| ----------- | ------ | ------------------------------------------------- |
| `low_risk`  | 3.9%   | Default for low-risk merchants                    |
| `high_risk` | 4.5%   | High-risk merchant category                       |
| `custom`    | Varies | Custom rate negotiated in your merchant agreement |

All tiers include a flat **\$1.00 per-transaction fee** in addition to the percentage rate.

<Tip>
  If you believe your fee tier is incorrect or want to discuss custom pricing, contact [support@useaxra.com](mailto:support@useaxra.com).
</Tip>

## Viewing settlement details

You can inspect the settlement status and fee breakdown for any payment by calling the payment detail endpoint:

```bash theme={null}
GET /business/payment/:paymentId
```

Check these fields in the response:

| Field                   | Description                                                                                         |
| ----------------------- | --------------------------------------------------------------------------------------------------- |
| `settlementStatus`      | Current settlement status (`PENDING_SETTLEMENT`, `SETTLED`, or `SETTLEMENT_FAILED`)                 |
| `metadata.feeBreakdown` | Itemized fee breakdown applied at settlement, including the percentage fee and flat transaction fee |

## Handling settlement webhooks

Subscribe to the `payment.settled` event in your [webhook handler](/manage/webhooks) to trigger downstream actions — such as fulfilling orders, updating accounting records, or initiating payouts — only after funds are confirmed in your wallet.

```json theme={null}
{
  "event": "payment.settled",
  "timestamp": "2026-03-22T10:00:00.000Z",
  "data": {
    "paymentId": "bpay_01H...",
    "amount": "49.99",
    "currency": "USD",
    "settledAt": "2026-03-22T10:00:00.000Z"
  }
}
```

<Warning>
  Do not treat `payment.completed` as confirmation that funds are in your wallet. Use `payment.settled` for any logic that depends on fund availability.
</Warning>