# List charges

Endpoint: GET /v1/charges
Version: 2.0.0
Security: oAuth2

## Query parameters:

  - `merchantId` (string)

  - `status` (string)
    Enum: "requires_payment", "processing", "succeeded", "failed", "cancelled", "refunded"

  - `createdAfter` (string)

  - `createdBefore` (string)

  - `limit` (integer)

  - `cursor` (string)

## Response 200 fields (application/json):

  - `items` (array)

  - `items.chargeId` (string, required)
    Example: "chg_01JH..."

  - `items.merchantId` (string, required)

  - `items.amount` (number, required)

  - `items.currency` (string, required)

  - `items.status` (string, required)
    Enum: "requires_payment", "processing", "succeeded", "failed", "cancelled", "refunded"

  - `items.paymentMethod` (string, required)
    - nfc: Tap-to-Pay via NFC
- qr: QR code payment
- alias: Alias/handle resolution
- card_present: Card present (chip/swipe)
    Enum: "nfc", "qr", "alias", "card_present"

  - `items.description` (string,null)

  - `items.reference` (string,null)

  - `items.qr` (object)

  - `items.qr.data` (string)
    QR payload (for rendering)

  - `items.qr.imageUrl` (string)
    Pre-rendered QR image URL

  - `items.qr.expiresAt` (string)

  - `items.payer` (object)

  - `items.payer.walletId` (string)

  - `items.payer.displayName` (string)

  - `items.txHash` (string,null)

  - `items.providerRef` (string,null)

  - `items.createdAt` (string, required)

  - `items.paidAt` (string,null)

  - `pagination` (object)

  - `pagination.nextCursor` (string,null)
    Example: "cursor_abc123"