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

# Reporting & Settlement

> Understand how Rampnow manages settlement, reconciliation, FX logs and reporting for payouts funded in USDC/USDT.

Rampnow provides a unified reporting framework so partners can track payout funding, FX conversion, settlement status and reconciliation across all corridors (INR, USD, EUR, PHP, IDR).\
All payouts are funded in **USDC or USDT**, with fiat settlement performed through local payout rails.

<Note>
  You receive reporting across three dimensions:\
  **(1) Funding → (2) FX Conversion → (3) Settlement**.\
  Each transfer order maintains full traceability through `reference`, `walletUid` and `traceId`.
</Note>

# Settlement Flow Overview

<Steps>
  <Step title="1. Stablecoin Funding Received" icon="coins">
    After a transfer order is created, Rampnow detects the incoming **USDC/USDT** transaction on the specified chain.\
    Funding details logged:

    * Sender address
    * Network
    * Transaction hash
    * Confirmed amount
  </Step>

  <Step title="2. FX Conversion Logged" icon="arrows-rotate">
    Rampnow converts crypto → fiat based on the live corridor FX routing engine.\
    Stored reporting fields:

    * FX rate applied
    * Spread (if applicable)
    * Converted fiat amount
    * Timestamp
  </Step>

  <Step title="3. Payout Execution" icon="arrow-right">
    Rampnow triggers the fiat payout (IMPS, ACH, SEPA, SWIFT, PHP/IDR rails).\
    Settlement logs include:

    * Payout reference
    * Bank transaction ID (if available)
    * Beneficiary details
    * Rail used
    * Estimated arrival time
  </Step>

  <Step title="4. Completion & Reconciliation" icon="check">
    Final state of the payout is recorded and available via API & webhook:

    * `completed`
    * `failed`
    * `processing`
    * `reversed` (rare cases)
  </Step>
</Steps>

# What You Can Track

## Funding Reports

Funding-level fields include:

| Field                           | Description                    |
| ------------------------------- | ------------------------------ |
| `cryptoTxnInfo.amount`          | Amount of USDC/USDT received   |
| `cryptoTxnInfo.chain`           | Network used for funding       |
| `cryptoTxnInfo.transactionHash` | On-chain hash                  |
| `cryptoTxnInfo.status`          | Confirmations status           |
| `expiry`                        | Funding deadline for the order |

## FX Conversion Logs

Every payout records the FX routing details:

| Field          | Description                                  |
| -------------- | -------------------------------------------- |
| `srcamount`    | Crypto-equivalent amount                     |
| `srccurrency`  | Should be USDC/USDT                          |
| `dstamount`    | Amount that will be delivered to beneficiary |
| `dstcurrency`  | INR / USD / EUR / PHP / IDR                  |
| `exchangeRate` | FX rate applied                              |
| `timestamp`    | Conversion timestamp                         |

<Info>
  FX rates are locked at the time of conversion, ensuring deterministic payout amounts.
</Info>

## Settlement Reports

Once a payout reaches the banking system:

| Field                  | Description                                      |
| ---------------------- | ------------------------------------------------ |
| `bankTxnInfo.receiver` | Full beneficiary payout details                  |
| `bankTxnInfo.sender`   | Rampnow or partner settlement account            |
| `bankTxnInfo.message`  | Bank-side reference message                      |
| `bankTxnInfo.fee`      | Any rail-specific charges                        |
| `payment.status`       | `processing`, `completed`, or `failed`           |
| `redirectUrl`          | Additional info if redirect-based payout is used |

***

# Reconciliation Workflow

<Steps>
  <Step title="1. Match internal reference" icon="tag">
    Use your own `reference` field (sent in CreateTransferOrder) to link each payout to your internal system.
  </Step>

  <Step title="2. Validate funding" icon="magnifying-glass">
    Match the incoming crypto transaction hash with your blockchain logs.
  </Step>

  <Step title="3. Check settlement status" icon="list-check">
    Call the Transfer Order APIs or subscribe to webhooks to track final payout state.
  </Step>

  <Step title="4. Download payout ledger" icon="file">
    Export combined payout logs (coming soon as CSV download).
  </Step>
</Steps>

# Webhook-Based Reporting

Webhook events ensure your system stays updated even without polling.

Example event types:

| Event Type                 | Description                     |
| -------------------------- | ------------------------------- |
| `payout.created`           | Transfer order initiated        |
| `payout.funding_confirmed` | USDC/USDT received              |
| `payout.fx_converted`      | Crypto → fiat conversion logged |
| `payout.processing`        | Payout sent to bank             |
| `payout.completed`         | Recipient received funds        |
| `payout.failed`            | Rejected due to bank error      |

### Webhook Payload Example

```json theme={null}
{
  "event": "payout.completed",
  "data": {
    "payoutId": "payout_123",
    "reference": "internal_20250101_0032",
    "dstCurrency": "INR",
    "dstAmount": "10000",
    "fxRate": "82.11",
    "completedAt": "2025-01-10T12:45:30Z"
  },
  "traceId": "abc123xyz"
}
```

<Check>
  Webhook retries and HMAC signature verification are supported (docs coming soon).
</Check>

## Ledger & Exporting (Coming Soon)

Rampnow will provide:

* Full payout ledger exports (CSV, JSON)
* Funding ledger with on-chain deposits
* FX ledger including rates + timestamps
* Settlement ledger per corridor

Each ledger will be downloadable directly from the Partner Dashboard.

## Best Practices

* Store reference + traceId for every payout
* Subscribe to webhooks instead of polling
* Log FX rates inside your system for audit purposes
* Use daily ledger exports for accounting reconciliation
* Match your internal batch IDs with Rampnow’s transfer orders

<Card title="Next: FX Routing" icon="arrows-rotate" href="/quickstart/make-payments/FX-routing">
  Learn how Rampnow determines FX rates and corridor pricing.
</Card>