Settlement & Reconciliation

Settlement & Reconciliation

This guide explains how transactions are finalized in 3PAY and how merchants can reconcile payments and payouts using on-chain data and dashboard records.

In 3PAY, a confirmed transaction is considered settled.

---

What settlement means in 3PAY

3PAY does not use a separate “settled” state.

A transaction is considered settled once it is confirmed on-chain and marked as Successful in the dashboard.

There is no intermediate settlement layer.

---

Transaction confirmation & finality

All fund movements in 3PAY rely on blockchain confirmations.

The lifecycle is simple:

1. Transaction is broadcasted on-chain
2. 3PAY detects the transaction
3. Required confirmations are reached
4. Transaction status becomes Successful
5. Balance is updated accordingly

Once a transaction is marked Successful, it is:

• Final
• Irreversible
• Fully reflected in balances

---

Transaction hash (on-chain reference)

Every confirmed transaction in 3PAY includes a transaction hash.

• The transaction hash is visible in the admin dashboard
• Clicking on a transaction opens the on-chain reference
• The hash serves as the single source of truth for verification

This allows merchants to:

• Independently verify transactions on the blockchain
• Audit payment and payout activity
• Reconcile internal records with on-chain data

---

Reconciliation model

3PAY reconciliation is based on direct mapping between on-chain transactions and dashboard records.

Each transaction includes:

• Transaction ID
• Transaction hash
• Asset and network
• Amount
• Status (e.g. Pending, Successful)
• Timestamp
• Associated invoice or user (where applicable)

There is a one-to-one relationship between:

• A confirmed on-chain transaction
• A successful transaction record in 3PAY

---

Reconciliation by payment type

Invoice payments

• Each invoice corresponds to a single payment
• Once confirmed, the invoice is marked as paid
• The transaction hash is attached to the invoice record

Wallet deposits

• Deposits are credited to the user wallet after confirmation
• Each deposit has its own transaction hash
• Balances reflect the sum of confirmed transactions

---

Reconciliation for payouts

For outgoing funds:

• Each payout generates an on-chain transaction
• The transaction hash is recorded in the dashboard
• The payout is considered complete once confirmed

This applies to:

• Manual payouts
• Withdrawal requests
• Auto-withdrawals
• Auto-payouts

---

Pending vs successful transactions

3PAY uses a clear and minimal status model:

• Pending Transaction detected but not yet confirmed

• Successful Transaction confirmed on-chain and finalized

Only Successful transactions should be used for accounting and reconciliation.

---

Sandbox vs live behavior

Sandbox data cannot be reconciled with live data.

---

Important notes

• There is no “soft settlement” or delayed settlement
• Confirmation equals settlement
• Blockchain confirmation time depends on network conditions
• Once successful, transactions cannot be reversed