Settlements

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

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.

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.

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.

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

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.

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.

If you believe your fee tier is incorrect or want to discuss custom pricing, contact support@useaxra.com.

Viewing settlement details

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

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 to trigger downstream actions — such as fulfilling orders, updating accounting records, or initiating payouts — only after funds are confirmed in your wallet.

{
  "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"
  }
}

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

Payments

Treasury

Webhooks

SDKs

Settlements

Settlement flow

Settlement statuses

Fee deductions at settlement

Viewing settlement details

Handling settlement webhooks

​Settlement flow

​Settlement statuses

​Fee deductions at settlement

​Viewing settlement details

​Handling settlement webhooks

Settlement flow

Settlement statuses

Fee deductions at settlement

Viewing settlement details

Handling settlement webhooks