Skip to main content

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.

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

1

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.
2

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.
3

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

StatusDescription
PENDING_SETTLEMENTPayment captured, awaiting fund clearance through card networks
SETTLEDFunds cleared and credited to your merchant wallet
SETTLEMENT_FAILEDSettlement 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:
TierRateApplies when
low_risk3.9%Default for low-risk merchants
high_risk4.5%High-risk merchant category
customVariesCustom 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:
FieldDescription
settlementStatusCurrent settlement status (PENDING_SETTLEMENT, SETTLED, or SETTLEMENT_FAILED)
metadata.feeBreakdownItemized 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.