Settlements

Viewing and tracking settlement transactions

Settlements

Settlements are transactions that transfer funds from platform accounts to merchant wallets. This guide explains how to view and understand settlements.

What Are Settlements?

Settlements complete the payment cycle by:

  • Moving funds from platform custody to merchant wallets
  • Executing after payments are confirmed
  • Deducting applicable fees
  • Recording on the blockchain

Accessing Settlements

  1. Click Settlements in the sidebar under the Ops section
  2. The settlements list displays all settlement transactions
Settlements list

Understanding the Settlements Grid

ColumnDescription
Settlement IDUnique identifier
Payment IDAssociated payment (if applicable)
OrganizationReceiving merchant
AmountSettlement amount
CurrencyCurrency/token
NetworkBlockchain network
StatusSettlement status
DestinationMerchant wallet address
Transaction HashBlockchain transaction ID
CreatedWhen settlement was initiated

Settlement Statuses

StatusDescription
PendingSettlement queued for processing
ProcessingSettlement being executed
CompletedSuccessfully settled on-chain
FailedSettlement could not complete

Filtering Settlements

By Status

  1. Click the Status column filter
  2. Select one or more statuses
  3. Click Apply

By Organization

  1. Click the Organization column filter
  2. Select or search for a merchant
  3. Click Apply

By Date Range

  1. Click the Created column filter
  2. Select a date range
  3. Click Apply

By Currency

  1. Click the Currency column filter
  2. Select the currency
  3. Click Apply

Viewing Settlement Details

Click on any settlement to see complete details:

Settlement Information

FieldDescription
Settlement IDUnique identifier
StatusCurrent status
CreatedWhen initiated
CompletedWhen finished (if completed)

Amount Details

FieldDescription
Gross AmountOriginal payment amount
Fee AmountFees deducted
Net AmountAmount sent to merchant
CurrencySettlement currency

Destination

FieldDescription
Wallet AddressMerchant's receiving address
NetworkBlockchain network
AccountSettlement account reference

Blockchain Details

FieldDescription
Transaction HashOn-chain transaction ID
Block NumberBlockchain block (when confirmed)
ConfirmationsNumber of confirmations

Click the Transaction Hash to view on a blockchain explorer.

Settlement Lifecycle

Payment Completed → Settlement Pending → Processing → Completed
                                             ↓
                                          Failed (retry may occur)

Common Tasks

Finding Settlements for a Payment

  1. Note the Payment ID
  2. Go to Settlements
  3. Filter by Payment ID (use search or column filter)

Or:

  1. Open the payment detail view
  2. Look for settlement information in the payment details

Checking Settlement Status

  1. Find the settlement in the list
  2. Check the Status column
  3. Click for details if needed

Viewing Transaction on Blockchain

  1. Open the settlement details
  2. Find the Transaction Hash
  3. Click to open in blockchain explorer
  4. Verify the on-chain transaction

Finding Delayed Settlements

  1. Go to Settlements
  2. Filter by Status = "Pending" or "Processing"
  3. Sort by Created ascending
  4. Review settlements that have been pending longest

Failed Settlements

When a settlement fails:

  1. Check the failure reason — Available in settlement details
  2. Common causes:
    • Insufficient gas/network fees
    • Invalid destination address
    • Network congestion
    • Technical issues
  3. Resolution — Failed settlements typically retry automatically
  4. Escalation — Contact support if failures persist

Permissions

RoleView Settlements
Super AdminYes
AdminYes
Payment OpsYes
Compliance OpsYes
CS OpsYes
Finance OpsYes
View OnlyYes

Related Topics