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

> ## Agent Instructions
> Treat these docs and the Whop MCP server as the source of truth for Whop API behavior. Don't infer endpoint behavior from marketing pages.
> MCP server: connect https://mcp.whop.com/mcp (streamable HTTP, browser sign-in, no API key in the client config) to search these docs and read or change live Whop data. Setup: https://docs.whop.com/developer/guides/ai_and_mcp.md
> Whop CLI: install with `curl -fsSL https://whop.com/install.sh | sh` to scaffold, run, and deploy Whop apps and websites. It acts on production, not the sandbox. Overview: https://docs.whop.com/cli/overview.md Agent mode: https://docs.whop.com/cli/agent-mode.md
> Hosting: Whop serves a site or app from the build `whop apps deploy` uploads, with rollbacks, secrets, and server logs. Guide: https://docs.whop.com/developer/websites/hosting.md
> Plugins: in Claude Code, run `/plugin marketplace add whopio/plugins`, then `/plugin install whop@whop`. Guide: https://docs.whop.com/developer/guides/plugins/claude-code.md Every agent tool: https://docs.whop.com/developer/ai/overview.md
> Environments: build and test in the sandbox (API `https://sandbox-api.whop.com/api/v1`, keys at https://sandbox.whop.com/dashboard/developer, SDK environment `Sandbox`; no real money). Production (API `https://api.whop.com/api/v1`, keys at https://whop.com/dashboard/developer, SDK environment `Production`, the SDK default) moves real money, so use it only at launch. The two share no accounts, keys, products, or webhooks, and their keys look identical: never mix them. Sandbox guide: https://docs.whop.com/developer/guides/sandbox.md Comparison: https://docs.whop.com/developer/quickstart.md
> API: send `Authorization: Bearer <API_KEY>` from your server only, and pin a dated version with the `Api-Version-Date` header. OpenAPI spec: https://api.whop.com/api/v1/openapi.json
> Which API: build on the Current API, whose pages live under https://docs.whop.com/api-reference/ (start at https://docs.whop.com/api-reference/overview.md). Pages under /api-reference/legacy/ are the Legacy API. Use one only when https://docs.whop.com/api-reference/stability.md lists the resource as Legacy-only.

# ActivityElement

> 계정의 원장 활동입니다. 들어오고 나간 모든 자금 거래를 최신순으로 보여 줍니다. 뷰어가 스크롤하면 목록이 다음 페이지를 불러오며, 행은 페이지를 이동하는 대신 어떤 행이 탭되었는지 보고하므로 자체 상세 화면을 열 수 있습니다.

> [!NOTE]
>
> 이 페이지는 `@whop/elements@1.10.0` 및 `@whop/elements-react@1.10.0`을 다룹니다.

*`v1.0.0`부터 지원.*

[`Wallet`](https://docs.whop.com/ko/elements/latest/wallet/overview) 안에 마운트됩니다. `accountId`와 `accessToken`은 그곳에서 가져옵니다. props와 콜백은 생성 옵션 또는 React props로 전달합니다. `refresh()`와 `setDateRange()`를 호출하려면 생성된 핸들 또는 React `ref`를 보관하세요.

뷰 계층 구조의 어디에나 마운트됩니다. `accountId`를 받아 자체 데이터를 로드하며, 클로저도 전달하면 뷰어가 탭한 행을 받을 수 있습니다.

```tsx React theme={null}
import { WhopElements, Wallet, ActivityElement } from "@whop/elements-react";
import { loadWhop } from "@whop/elements";

function Example() {
  return (
    <WhopElements elements={loadWhop()}>
      <Wallet /* options */>
        <ActivityElement onActivitySelected={(e) => console.log(e)} onActivityHovered={(e) => console.log(e)} onSeeAllRequested={(e) => console.log(e)} onDateRangeChanged={(e) => console.log(e)} />
      </Wallet>
    </WhopElements>
  );
}
```

```html JavaScript theme={null}
<script src="https://cdn.whop.com/elements/amber/elements.js" data-whop-elements></script>
<script type="module">
  const wallet = window.WhopElements().wallet.create({ /* options */ });
  wallet.create('activity', {
    onActivitySelected: (e) => console.log(e),
    onActivityHovered: (e) => console.log(e),
    onSeeAllRequested: (e) => console.log(e),
    onDateRangeChanged: (e) => console.log(e)
  }).mount('#wallet-activity');
</script>
```

```swift Swift theme={null}
import SwiftUI
import WhopElements

// WhopSDK.configure(tokenProvider:) runs once at app launch. See Getting started.
struct ActivityScreen: View {
    var body: some View {
        ScrollView {
            ActivityElement(
                accountId: "biz_xxxx"
            ) { activity in
                print(activity.title, activity.amount)
            }
            .padding()
        }
    }
}
```

예시 데이터입니다. [Playground 열기](https://docs.whop.com/ko/elements/latest/wallet/overview#playground).

[iPhone 시뮬레이터에서 실행 중인 ActivityElement](https://app.revyl.ai/embed/7289cae9-8eaf-4d14-a771-fb05c879c6c5?controls=0)

## Props

**currency** `string`

이 통화의 활동만 표시합니다. 지정하지 않으면 모든 통화의 활동이 표시됩니다.

**accessToken** `string`

읽기에 사용하는 범위 지정 토큰입니다. 계정에는 `company:balance:read`가, 사용자에게는 `user:balance:read`가 필요합니다. 서버에서 `POST /api/v1/access_tokens`로 발급하세요. 없으면 읽기에 뷰어 자신의 세션이 사용되며, 이는 동일 출처에서만 작동합니다.

**maxItems** `number`

최근 활동 미리보기를 위해 최대 이 개수만큼의 행만 표시하고 페이지 로딩을 멈춥니다. 목록에 See all activity 컨트롤이 추가되며, 이 컨트롤은 페이지를 이동하는 대신 `seeAllRequested`를 보고합니다.

**canOpenCardTransactionDetails** `boolean`

끄면 카드 거래 행이 `activitySelected`를 발생시키지 않고 비활성 상태(클릭 및 호버 없음)로 렌더링됩니다. 뷰어가 해당 세부 정보를 볼 권한이 없다는 것을 알고 있을 때 사용하세요. 기본값은 `true`입니다.

**defaultLineTypes** `string[]`

엘리먼트가 마운트되거나 계정이 바뀔 때 선택되는 활동 유형입니다. 뷰어는 기본 제공 필터로 이를 변경할 수 있습니다. 기본값은 `[]`입니다.

**값**

각 항목은 `"withdrawal"`, `"ad_affiliate_payout_received"`, `"ad_budget_release"`, `"ad_campaign_budget"`, `"ad_publisher_payout"`, `"ad_publisher_payout_received"`, `"ad_spend_charge"`, `"affiliate_fee"`, `"airdrop"`, `"airdrop_link_created"`, `"airdrop_link_redeemed"`, `"airdrop_link_returned"`, `"airdrop_reversal"`, `"application_fee"`, `"application_fee_payout"`, `"billing_percentage_fee"`, `"buyer_fee"`, `"card_spend_authorization"`, `"card_spend_authorization_void"`, `"card_spend_refund"`, `"cashback"`, `"cross_border_percentage_fee"`, `"currency_conversion_incoming"`, `"currency_conversion_outgoing"`, `"dispute_alert_fee"`, `"dispute_hold_adjustment"`, `"economic_intelligence_percentage_fee"`, `"fraud_prevention_fee"`, `"fx_percentage_fee"`, `"high_risk_merchant_fee"`, `"internal_balance_transfer_incoming"`, `"internal_balance_transfer_outgoing"`, `"levels_rebate"`, `"misc_reversal"`, `"onboarding_reward"`, `"onchain_deposit"`, `"onchain_internal_transfer_incoming"`, `"onchain_internal_transfer_outgoing"`, `"onchain_swap_target"`, `"onchain_wallet_transfer_incoming"`, `"onchain_wallet_transfer_outgoing"`, `"orchestration_percentage_fee"`, `"partner_grant_reward"`, `"passthrough_gmv"`, `"payment_dispute"`, `"payment_dispute_adjustment"`, `"payment_dispute_fee"`, `"payment_dispute_reversal"`, `"payment_gross"`, `"payment_gross_reversal"`, `"payment_processing_fixed_fee"`, `"payment_processing_percentage_fee"`, `"payment_referral"`, `"payment_referral_refund"`, `"payment_referral_reversal"`, `"payment_refund"`, `"payment_refund_reversal"`, `"payment_revshare"`, `"payment_revshare_payout"`, `"payment_revshare_refund"`, `"payment_revshare_reversal"`, `"payout_fee"`, `"platform_affiliate_payment"`, `"platform_affiliate_payment_reversal"`, `"platform_balance_payment"`, `"platform_balance_payment_refund"`, `"platform_balance_transfer_incoming"`, `"platform_balance_transfer_outgoing"`, `"platform_covered_dispute"`, `"platform_credits_granted"`, `"platform_credits_payment"`, `"platform_credits_payment_refund"`, `"platform_markup_fee"`, `"platform_markup_fee_payout"`, `"promo_reversal"`, `"resolution_center_refund"`, `"revshare_percentage_fee"`, `"sales_tax_fee"`, `"sales_tax_remittance"`, `"sales_tax_remittance_reversal"`, `"stripe_domestic_processing_fee"`, `"stripe_international_processing_fee"`, `"three_ds_fixed_fee"`, `"topup"`, `"topup_reversal"`, `"treasury_payin"`, `"whop_processing_fee"`, `"withdrawal_clawback"`, `"withdrawal_clawback_reversal"`, `"withdrawal_reclassification"`, `"withdrawal_reversal"` 중 하나입니다.

**hideFilters** `boolean`

뷰어가 필터링하지 않는 간결한 목록을 위해 필터 칩을 숨깁니다. 기본값은 `false`입니다.

## 이벤트

생성 옵션 또는 React props로 콜백을 전달합니다.

### `onActivitySelected`

행이 클릭되었습니다. 해당 행에 대한 자체 상세 화면이나 경로를 여세요. 엘리먼트는 절대 페이지를 이동하지 않습니다.

**payload** `object`

**속성**

**activity** `LedgerActivity` *required*

**속성**

**object** `"ledger_activity"` *required*

**id** `string` *required*

원장 활동 ID입니다.

**line\_type** `string` *required*

이 활동이 기록된 원장 항목 카테고리입니다.

**값**

`"withdrawal"`, `"accelerated_settlement_fee"`, `"account_settlement"`, `"ad_affiliate_payout"`, `"ad_affiliate_payout_received"`, `"ad_balance_funding_receipt"`, `"ad_budget_release"`, `"ad_campaign_budget"`, `"ad_funding_disbursement"`, `"ad_income_expense"`, `"ad_income_receipt"`, `"ad_network_cost"`, `"ad_network_settlement"`, `"ad_publisher_payout"`, `"ad_publisher_payout_received"`, `"ad_spend_charge"`, `"ad_spend_margin"`, `"ad_spend_purchase"`, `"ads_card_spread"`, `"affiliate_fee"`, `"aggregated_fee"`, `"airdrop"`, `"airdrop_expense"`, `"airdrop_expense_reversal"`, `"airdrop_link_canceled"`, `"airdrop_link_claimed"`, `"airdrop_link_created"`, `"airdrop_link_funded"`, `"airdrop_link_redeemed"`, `"airdrop_link_returned"`, `"airdrop_reversal"`, `"application_fee"`, `"application_fee_payable"`, `"application_fee_payout"`, `"bad_debt_expense"`, `"bad_debt_offset"`, `"balance_reservation"`, `"balance_reservation_hold"`, `"balance_reservation_release"`, `"balance_reservation_reversal"`, `"billing_percentage_fee"`, `"buyer_fee"`, `"card_interchange"`, `"card_interchange_receivable"`, `"card_load_deposit"`, `"card_load_transfer"`, `"card_spend_authorization"`, `"card_spend_authorization_hold"`, `"card_spend_authorization_void"`, `"card_spend_authorization_void_release"`, `"card_spend_capture"`, `"card_spend_capture_offset"`, `"card_spend_refund"`, `"card_spend_refund_offset"`, `"card_unload_deposit"`, `"card_unload_transfer"`, `"cashback"`, `"cashback_expense"`, `"cashback_funding"`, `"clawback_fee"`, `"clawback_receivable"`, `"clawback_receivable_reversal"`, `"clawback_receivable_settlement"`, `"clawback_receivable_settlement_reversal"`, `"company_referral"`, `"connected_account_clawback"`, `"connected_account_negative_balance"`, `"cross_border_percentage_fee"`, `"currency_conversion_incoming"`, `"currency_conversion_outgoing"`, `"dispute_alert_fee"`, `"dispute_hold_adjustment"`, `"dispute_hold_blocked"`, `"dispute_management_fee"`, `"dispute_payable_clearing"`, `"dispute_payable_reversal"`, `"dispute_representment_fee"`, `"dispute_settlement"`, `"dispute_settlement_reversal"`, `"dispute_unreconciled_clearing"`, `"dispute_unreconciled_reversal"`, `"economic_intelligence_percentage_fee"`, `"external_account_connection_fee"`, `"external_card_load_deposit"`, `"external_card_load_offset"`, `"fraud_prevention_fee"`, `"fx_gain_loss"`, `"fx_markup"`, `"fx_percentage_fee"`, `"fx_settlement_gain_loss"`, `"high_risk_merchant_fee"`, `"identity_verification_fee"`, `"installment_default"`, `"internal_balance_transfer_incoming"`, `"internal_balance_transfer_outgoing"`, `"internal_withdrawal"`, `"internal_withdrawal_complete"`, `"internal_withdrawal_fee"`, `"internal_withdrawal_fee_reversal"`, `"internal_withdrawal_in_transit"`, `"internal_withdrawal_in_transit_reversal"`, `"internal_withdrawal_markup_fee"`, `"internal_withdrawal_markup_fee_payout"`, `"internal_withdrawal_markup_fee_payout_reversal"`, `"internal_withdrawal_markup_fee_reversal"`, `"internal_withdrawal_payable"`, `"internal_withdrawal_payable_reversal"`, `"internal_withdrawal_reversal"`, `"legacy_crypto_payment"`, `"legacy_payment"`, `"legacy_payment_refund"`, `"levels_points_ads"`, `"levels_points_burned"`, `"levels_points_card"`, `"levels_points_issued"`, `"levels_points_partner"`, `"levels_points_trading"`, `"levels_rebate"`, `"license_sale"`, `"license_sale_commission"`, `"license_sale_revenue"`, `"marketing_expense"`, `"marketplace_affiliate_fee"`, `"misc_purchase"`, `"misc_refund"`, `"misc_reversal"`, `"onboarding_reward"`, `"onchain_deposit"`, `"onchain_deposit_offset"`, `"onchain_internal_transfer_incoming"`, `"onchain_internal_transfer_outgoing"`, `"onchain_platform_transfer_incoming"`, `"onchain_platform_transfer_outgoing"`, `"onchain_swap_offset"`, `"onchain_swap_source"`, `"onchain_swap_target"`, `"onchain_wallet_transfer_incoming"`, `"onchain_wallet_transfer_outgoing"`, `"onchain_withdrawal"`, `"onchain_withdrawal_offset"`, `"orchestration_percentage_fee"`, `"partner_grant_reward"`, `"passthrough_gmv"`, `"passthrough_gmv_offset"`, `"payment_dispute"`, `"payment_dispute_adjustment"`, `"payment_dispute_fee"`, `"payment_dispute_reversal"`, `"payment_gross"`, `"payment_gross_reversal"`, `"payment_processing_fixed_fee"`, `"payment_processing_percentage_fee"`, `"payment_receivable_clearing"`, `"payment_receivable_reversal"`, `"payment_receivable_settlement"`, `"payment_referral"`, `"payment_referral_payable"`, `"payment_referral_refund"`, `"payment_referral_reversal"`, `"payment_refund"`, `"payment_refund_fee"`, `"payment_refund_reversal"`, `"payment_return_fee"`, `"payment_revshare"`, `"payment_revshare_payout"`, `"payment_revshare_refund"`, `"payment_revshare_reversal"`, `"payment_unreconciled_clearing"`, `"payment_unreconciled_reversal"`, `"payout_fee"`, `"payout_receivable"`, `"payout_subsidy"`, `"payout_unreconciled_clearing"`, `"platform_affiliate_payment"`, `"platform_affiliate_payment_reversal"`, `"platform_balance_payment"`, `"platform_balance_payment_refund"`, `"platform_balance_transfer_fee"`, `"platform_balance_transfer_incoming"`, `"platform_balance_transfer_outgoing"`, `"platform_covered_dispute"`, `"platform_credits_granted"`, `"platform_credits_payment"`, `"platform_credits_payment_refund"`, `"platform_earning"`, `"platform_earning_settlement"`, `"platform_earning_unreconciled_clearing"`, `"platform_markup_fee"`, `"platform_markup_fee_payout"`, `"promo_reversal"`, `"psp_accelerated_settlement_fee"`, `"psp_account_debit"`, `"psp_account_updater_fee"`, `"psp_adjusted_processing_fee"`, `"psp_authentication_fee"`, `"psp_bank_pull_clearing"`, `"psp_bank_pull_settlement"`, `"psp_billing_fee"`, `"psp_clawback_fee"`, `"psp_clawback_settlement"`, `"psp_clawback_settlement_reversal"`, `"psp_collection_settlement"`, `"psp_commission_fee"`, `"psp_connect_fee"`, `"psp_correction"`, `"psp_currency_conversion_incoming"`, `"psp_currency_conversion_outgoing"`, `"psp_currency_conversion_receivable"`, `"psp_currency_conversion_receivable_clearing"`, `"psp_dispute_alert_fee"`, `"psp_dispute_fee"`, `"psp_dispute_management_fee"`, `"psp_dispute_payable"`, `"psp_external_account_connection_fee"`, `"psp_fixed_fee"`, `"psp_fx_adjustment"`, `"psp_gateway_fee"`, `"psp_identity_verification_fee"`, `"psp_interchange_fee"`, `"psp_invoice_tax_fee"`, `"psp_invoicing_fee"`, `"psp_markup_fee"`, `"psp_network_token_fee"`, `"psp_optimization_fee"`, `"psp_payin_clearing"`, `"psp_payin_settlement"`, `"psp_payment_method_fee"`, `"psp_payment_receivable"`, `"psp_payout_consolidation"`, `"psp_payout_deposit"`, `"psp_payout_fee"`, `"psp_payout_receivable"`, `"psp_payout_receivable_clearing"`, `"psp_payout_settlement"`, `"psp_payout_settlement_reversal"`, `"psp_pool_clearing"`, `"psp_pool_dispute_settlement"`, `"psp_pool_refund_clearing"`, `"psp_pool_refund_settlement"`, `"psp_pool_settlement"`, `"psp_processing_fee"`, `"psp_receivable_pooled"`, `"psp_recipient_wallet_load"`, `"psp_refund_fee"`, `"psp_refund_payable"`, `"psp_reserve_hold"`, `"psp_reserve_release"`, `"psp_risk_fee"`, `"psp_scheme_fee"`, `"psp_service_fee"`, `"psp_tax_filing_fee"`, `"psp_tax_service_fee"`, `"psp_terminal_fee"`, `"psp_transfer_settlement"`, `"psp_transfer_settlement_reversal"`, `"psp_treasury_fee"`, `"psp_variable_fee"`, `"psp_withholding_tax"`, `"recipient_wallet_load"`, `"referral_bonus"`, `"refund_payable_clearing"`, `"refund_payable_reversal"`, `"refund_settlement"`, `"refund_settlement_reversal"`, `"refund_unreconciled_clearing"`, `"refund_unreconciled_reversal"`, `"resolution_center_refund"`, `"revshare_percentage_fee"`, `"sales_tax_collected"`, `"sales_tax_collected_reversal"`, `"sales_tax_fee"`, `"sales_tax_remittance"`, `"sales_tax_remittance_reversal"`, `"sales_tax_remitted"`, `"settlement_rounding_variance"`, `"settlement_shortfall_loss"`, `"software_rental_revshare"`, `"software_rental_transaction"`, `"stripe_domestic_processing_fee"`, `"stripe_international_processing_fee"`, `"swap_fee"`, `"tax_filing_fee"`, `"three_ds_fixed_fee"`, `"topup"`, `"topup_fee"`, `"topup_reversal"`, `"trading_account_deposit"`, `"trading_account_deposit_offset"`, `"trading_account_withdrawal"`, `"trading_account_withdrawal_offset"`, `"treasury_fee"`, `"treasury_payin"`, `"treasury_payin_receivable"`, `"whop_processing_fee"`, `"whop_swap_fee_received"`, `"withdrawal_clawback"`, `"withdrawal_clawback_reversal"`, `"withdrawal_fee"`, `"withdrawal_fee_reversal"`, `"withdrawal_markup_fee"`, `"withdrawal_markup_fee_payout"`, `"withdrawal_markup_fee_payout_reversal"`, `"withdrawal_markup_fee_reversal"`, `"withdrawal_payable"`, `"withdrawal_payable_clearing"`, `"withdrawal_payable_clearing_reversal"`, `"withdrawal_payable_reversal"`, `"withdrawal_reclassification"`, `"withdrawal_reversal"`, `"withdrawal_topup_adjustment"`, `"deposit"`, `"wallet_transfer_incoming"`, `"wallet_transfer_outgoing"`, `"swap_source"`, `"swap_target"` 중 하나입니다.

**amount** `string` *required*

통화의 최소 정밀도 단위로 표시한 부호 있는 금액입니다.

**usd\_amount** `string | null` *required*

이 거래의 달러 가치를 10진수 문자열로 나타내며, `amount`와 같은 부호를 가집니다. 항목이 기록된 시점의 환율로 기록 금액에서 환산되며(지갑 잔액 차트 및 재무 보고서와 같은 가격 기준), 따라서 암호화폐 행에도 달러 가치가 포함됩니다. Whop이 환율을 보유하지 않은 통화의 경우 `null`입니다.

**currency** `object` *required*

이 원장 활동의 통화입니다.

**속성**

**code** `string` *required*

**precision** `string` *required*

**posted\_at** `string` *required*

활동이 원장에 기록된 시각입니다.

**available\_at** `string | null` *required*

이 활동이 사용 가능한 자금에 영향을 주는 시점의 ISO 8601 타임스탬프입니다. 대기 중인 확정 자금 해제 버킷의 입금 및 출금은 예정된 해제일의 00:00:00 UTC이고, 환불, 분쟁, 지급을 포함하여 정산된 사용 가능 자금에 대한 입금 및 출금은 기록 시각입니다. 온체인 행을 포함하여 이러한 경로 밖의 활동은 Null입니다. available\_after/before 필터는 이 값의 UTC 날짜를 사용합니다. 기본 활동에서는 옵트인 적립금을 포함한 일부 거래가 제외됩니다.

**resource** `object | null` *required*

이 원장 활동과 연결된 리소스입니다.

**형태 1**

**object** `"account"` *required*

**id** `string` *required*

**title** `string | null` *required*

**route** `string | null` *required*

**logo\_url** `string | null` *required*

**형태 2**

**object** `"user"` *required*

**id** `string` *required*

**name** `string | null` *required*

**username** `string | null` *required*

**profile\_picture\_url** `string | null` *required*

**형태 3**

**object** `"bounty"` *required*

**id** `string` *required*

**title** `string` *required*

**status** `string` *required*

**형태 4**

**object** `"ledger_account"` *required*

**id** `string` *required*

**owner** `object | null` *required*

**형태 1**

**object** `"account"` *required*

**id** `string` *required*

**title** `string | null` *required*

**route** `string | null` *required*

**logo\_url** `string | null` *required*

**형태 2**

**object** `"user"` *required*

**id** `string` *required*

**name** `string | null` *required*

**username** `string | null` *required*

**profile\_picture\_url** `string | null` *required*

**형태 5**

**object** `"payment_method"` *required*

**id** `string` *required*

**payment\_method\_type** `string | null` *required*

**gateway\_type** `string | null` *required*

**card** `object | null` *required*

**속성**

**brand** `string | null` *required*

**last4** `string | null` *required*

**exp\_month** `number | null` *required*

**exp\_year** `number | null` *required*

**bank** `object | null` *required*

**속성**

**bank\_name** `string | null` *required*

**account\_name** `string | null` *required*

**last4** `string | null` *required*

**account\_type** `string | null` *required*

**email\_identifier** `string | null` *required*

**형태 6**

**object** `"payout_method"` *required*

**id** `string` *required*

**nickname** `string | null` *required*

**institution\_name** `string | null` *required*

**account\_reference** `string | null` *required*

**provider** `string | null` *required*

**destination\_currency\_code** `string | null` *required*

**형태 7**

**object** `"card_transaction"` *required*

**id** `string` *required*

**card\_id** `string | null` *required*

**merchant\_name** `string | null` *required*

**merchant\_icon\_url** `string | null` *required*

**merchant\_category** `string | null` *required*

**status** `string | null` *required*

**usd\_amount** `string | null` *required*

**local\_amount** `string | null` *required*

**local\_currency** `string | null` *required*

**cashback\_usd** `string | null` *required*

**levels\_points** `string | null` *required*

**authorized\_at** `string | null` *required*

**posted\_at** `string | null` *required*

**declined\_reason** `string | null` *required*

**source** `object | null` *required*

이 원장 활동의 출처입니다. 플랫폼 마크업 수수료는 object platform\_fee와 원장 활동 ID를 사용합니다.

**속성**

**object** `string` *required*

**id** `string` *required*

**fee\_kind** `string | null`

`"deposit"`, `"transfer"`, `"card_spend"`, `"payout"`, `"swap"`, `null` 중 하나입니다.

**status** `string | null`

**payment\_amount** `Money | null`

**속성**

**currency** `string` *required*

소문자로 된 세 글자 ISO 4217 통화 코드입니다.

**amount** `string` *required*

주 단위 금액을 정확한 10진수 문자열로 나타냅니다. `"10.00"`은 10달러입니다. 전송 중에 부동 소수점 반올림이 일어나지 않도록 문자열을 사용합니다.

**decimals** `number` *required*

금액이 실제로 가지는 소수 자릿수로, 청구 자체에 적용되는 정밀도입니다.

**display\_decimals** `number` *required*

표시할 소수 자릿수입니다. 보통 `decimals`와 같지만 의도적으로 항상 같지는 않습니다. COP는 센타보 단위로 청구되지만 페소 단위로 표기되므로 각각 `2`와 `0`입니다. 이 값을 사용하여 자체 로케일로 숫자를 포맷하세요.

**payment\_method\_type** `string | null`

**payment\_processor** `string | null`

**card\_brand** `string | null`

**reason** `string | null`

**notes** `string | null`

**risk\_review\_hold** `boolean | null`

**claim\_url** `string | null`

**amount\_float** `number | null`

**payout\_amount** `Money | null`

**속성**

**currency** `string` *required*

소문자로 된 세 글자 ISO 4217 통화 코드입니다.

**amount** `string` *required*

주 단위 금액을 정확한 10진수 문자열로 나타냅니다. `"10.00"`은 10달러입니다. 전송 중에 부동 소수점 반올림이 일어나지 않도록 문자열을 사용합니다.

**decimals** `number` *required*

금액이 실제로 가지는 소수 자릿수로, 청구 자체에 적용되는 정밀도입니다.

**display\_decimals** `number` *required*

표시할 소수 자릿수입니다. 보통 `decimals`와 같지만 의도적으로 항상 같지는 않습니다. COP는 센타보 단위로 청구되지만 페소 단위로 표기되므로 각각 `2`와 `0`입니다. 이 값을 사용하여 자체 로케일로 숫자를 포맷하세요.

**fee\_amount** `Money | null`

**속성**

**currency** `string` *required*

소문자로 된 세 글자 ISO 4217 통화 코드입니다.

**amount** `string` *required*

주 단위 금액을 정확한 10진수 문자열로 나타냅니다. `"10.00"`은 10달러입니다. 전송 중에 부동 소수점 반올림이 일어나지 않도록 문자열을 사용합니다.

**decimals** `number` *required*

금액이 실제로 가지는 소수 자릿수로, 청구 자체에 적용되는 정밀도입니다.

**display\_decimals** `number` *required*

표시할 소수 자릿수입니다. 보통 `decimals`와 같지만 의도적으로 항상 같지는 않습니다. COP는 센타보 단위로 청구되지만 페소 단위로 표기되므로 각각 `2`와 `0`입니다. 이 값을 사용하여 자체 로케일로 숫자를 포맷하세요.

**fee\_type** `"exclusive" | "inclusive" | null`

**created\_by\_user** `UserSummary | null`

**속성**

**id** `string` *required*

`user_` 접두사가 붙은 사용자 ID입니다.

**username** `string` *required*

공개 사용자 이름입니다.

**name** `string | null` *required*

표시 이름입니다.

**profile\_picture** `UserProfilePicture` *required*

아바타 래퍼입니다. `url`은 항상 존재하며, 사용자가 사진을 설정하지 않은 경우 생성된 플레이스홀더를 사용합니다.

**속성**

**url** `string` *required*

아바타 이미지 URL입니다. 항상 존재하며, 사용자가 사진을 설정하지 않은 경우 생성된 플레이스홀더입니다.

**trace\_code** `string | null`

**created\_at** `string | null`

**estimated\_arrival** `string | null`

**payer\_name** `string | null`

**payout\_token\_nickname** `string | null`

**tx\_hash** `string | null`

**sender\_address** `string | null`

**chain** `string | null`

**from\_amount** `string | null`

**from\_currency** `string | null`

**to\_amount** `string | null`

**to\_currency** `string | null`

**payout\_destination** `object | null`

**속성**

**payer\_name** `string | null`

**icon\_url** `string | null`

**security\_answer** `string | null`

**\[key: string]** `unknown` *required*

**payment** `object | null`

이 원장 활동과 관련된 결제입니다. 리치 리소스 하이드레이션이 활성화되어 있고 거래가 결제와 연결된 경우에 포함됩니다.

**속성**

**object** `"payment"` *required*

**id** `string` *required*

**amount** `Money | null` *required*

**속성**

**currency** `string` *required*

소문자로 된 세 글자 ISO 4217 통화 코드입니다.

**amount** `string` *required*

주 단위 금액을 정확한 10진수 문자열로 나타냅니다. `"10.00"`은 10달러입니다. 전송 중에 부동 소수점 반올림이 일어나지 않도록 문자열을 사용합니다.

**decimals** `number` *required*

금액이 실제로 가지는 소수 자릿수로, 청구 자체에 적용되는 정밀도입니다.

**display\_decimals** `number` *required*

표시할 소수 자릿수입니다. 보통 `decimals`와 같지만 의도적으로 항상 같지는 않습니다. COP는 센타보 단위로 청구되지만 페소 단위로 표기되므로 각각 `2`와 `0`입니다. 이 값을 사용하여 자체 로케일로 숫자를 포맷하세요.

**payment\_method\_type** `string | null` *required*

**payment\_processor** `string | null` *required*

**card\_brand** `string | null` *required*

**card\_last4** `string | null` *required*

**user** `object | null` *required*

**속성**

**id** `string` *required*

**name** `string` *required*

**email** `string | null` *required*

**product** `object | null` *required*

**속성**

**id** `string` *required*

**name** `string` *required*

**plan** `object | null` *required*

**속성**

**id** `string` *required*

**name** `string | null` *required*

**created\_at** `string` *required*

**payment\_id** `string | null`

환불 및 분쟁을 포함한 모든 결제 관련 활동의 결제 ID입니다.

**user\_id** `string | null`

결제와 연결된 고객의 ID입니다.

**user\_name** `string | null`

결제와 연결된 고객의 표시 이름입니다.

**user\_email** `string | null`

결제와 연결된 고객의 이메일입니다. member:email:read가 필요합니다.

**product\_id** `string | null`

해당하는 경우 결제와 연결된 상품의 ID입니다.

**product\_name** `string | null`

해당하는 경우 결제와 연결된 상품의 이름입니다.

**plan\_id** `string | null`

해당하는 경우 결제와 연결된 옵션의 ID입니다.

**plan\_name** `string | null`

해당하는 경우 결제와 연결된 옵션의 이름입니다.

**account** `object`

이 행의 원장을 소유한 뷰어 계정입니다. 응답이 소유 계정을 집계하는 경우(include\_owned\_accounts=true)에만 존재하며, 그 외에는 생략됩니다.

**형태 1**

**object** `"account"` *required*

**id** `string` *required*

**title** `string | null` *required*

**route** `string | null` *required*

**logo\_url** `string | null` *required*

**형태 2**

**object** `"user"` *required*

**id** `string` *required*

**name** `string | null` *required*

**username** `string | null` *required*

**profile\_picture\_url** `string | null` *required*

**ledger\_account\_id** `string | null`

이 행이 속한 원장 계정(ldgr\_ 식별자)입니다. 응답이 소유 계정을 집계하는 경우(include\_owned\_accounts=true)에만 존재하며, 그 외에는 생략됩니다. `account`와 함께 사용하여 드로어와 대시보드 링크의 범위를 소유 비즈니스로 지정하세요.

### `onActivityHovered`

포인터가 행에 들어오거나 행에서 벗어났습니다(`null`). 잔액 차트에서 해당 행을 표시하는 것처럼, 같은 시점을 자체 UI에서도 가리키세요.

**payload** `object | null`

**속성**

**activity** `LedgerActivity` *required*

**속성**

**object** `"ledger_activity"` *required*

**id** `string` *required*

원장 활동 ID입니다.

**line\_type** `string` *required*

이 활동이 기록된 원장 항목 카테고리입니다.

**값**

`"withdrawal"`, `"accelerated_settlement_fee"`, `"account_settlement"`, `"ad_affiliate_payout"`, `"ad_affiliate_payout_received"`, `"ad_balance_funding_receipt"`, `"ad_budget_release"`, `"ad_campaign_budget"`, `"ad_funding_disbursement"`, `"ad_income_expense"`, `"ad_income_receipt"`, `"ad_network_cost"`, `"ad_network_settlement"`, `"ad_publisher_payout"`, `"ad_publisher_payout_received"`, `"ad_spend_charge"`, `"ad_spend_margin"`, `"ad_spend_purchase"`, `"ads_card_spread"`, `"affiliate_fee"`, `"aggregated_fee"`, `"airdrop"`, `"airdrop_expense"`, `"airdrop_expense_reversal"`, `"airdrop_link_canceled"`, `"airdrop_link_claimed"`, `"airdrop_link_created"`, `"airdrop_link_funded"`, `"airdrop_link_redeemed"`, `"airdrop_link_returned"`, `"airdrop_reversal"`, `"application_fee"`, `"application_fee_payable"`, `"application_fee_payout"`, `"bad_debt_expense"`, `"bad_debt_offset"`, `"balance_reservation"`, `"balance_reservation_hold"`, `"balance_reservation_release"`, `"balance_reservation_reversal"`, `"billing_percentage_fee"`, `"buyer_fee"`, `"card_interchange"`, `"card_interchange_receivable"`, `"card_load_deposit"`, `"card_load_transfer"`, `"card_spend_authorization"`, `"card_spend_authorization_hold"`, `"card_spend_authorization_void"`, `"card_spend_authorization_void_release"`, `"card_spend_capture"`, `"card_spend_capture_offset"`, `"card_spend_refund"`, `"card_spend_refund_offset"`, `"card_unload_deposit"`, `"card_unload_transfer"`, `"cashback"`, `"cashback_expense"`, `"cashback_funding"`, `"clawback_fee"`, `"clawback_receivable"`, `"clawback_receivable_reversal"`, `"clawback_receivable_settlement"`, `"clawback_receivable_settlement_reversal"`, `"company_referral"`, `"connected_account_clawback"`, `"connected_account_negative_balance"`, `"cross_border_percentage_fee"`, `"currency_conversion_incoming"`, `"currency_conversion_outgoing"`, `"dispute_alert_fee"`, `"dispute_hold_adjustment"`, `"dispute_hold_blocked"`, `"dispute_management_fee"`, `"dispute_payable_clearing"`, `"dispute_payable_reversal"`, `"dispute_representment_fee"`, `"dispute_settlement"`, `"dispute_settlement_reversal"`, `"dispute_unreconciled_clearing"`, `"dispute_unreconciled_reversal"`, `"economic_intelligence_percentage_fee"`, `"external_account_connection_fee"`, `"external_card_load_deposit"`, `"external_card_load_offset"`, `"fraud_prevention_fee"`, `"fx_gain_loss"`, `"fx_markup"`, `"fx_percentage_fee"`, `"fx_settlement_gain_loss"`, `"high_risk_merchant_fee"`, `"identity_verification_fee"`, `"installment_default"`, `"internal_balance_transfer_incoming"`, `"internal_balance_transfer_outgoing"`, `"internal_withdrawal"`, `"internal_withdrawal_complete"`, `"internal_withdrawal_fee"`, `"internal_withdrawal_fee_reversal"`, `"internal_withdrawal_in_transit"`, `"internal_withdrawal_in_transit_reversal"`, `"internal_withdrawal_markup_fee"`, `"internal_withdrawal_markup_fee_payout"`, `"internal_withdrawal_markup_fee_payout_reversal"`, `"internal_withdrawal_markup_fee_reversal"`, `"internal_withdrawal_payable"`, `"internal_withdrawal_payable_reversal"`, `"internal_withdrawal_reversal"`, `"legacy_crypto_payment"`, `"legacy_payment"`, `"legacy_payment_refund"`, `"levels_points_ads"`, `"levels_points_burned"`, `"levels_points_card"`, `"levels_points_issued"`, `"levels_points_partner"`, `"levels_points_trading"`, `"levels_rebate"`, `"license_sale"`, `"license_sale_commission"`, `"license_sale_revenue"`, `"marketing_expense"`, `"marketplace_affiliate_fee"`, `"misc_purchase"`, `"misc_refund"`, `"misc_reversal"`, `"onboarding_reward"`, `"onchain_deposit"`, `"onchain_deposit_offset"`, `"onchain_internal_transfer_incoming"`, `"onchain_internal_transfer_outgoing"`, `"onchain_platform_transfer_incoming"`, `"onchain_platform_transfer_outgoing"`, `"onchain_swap_offset"`, `"onchain_swap_source"`, `"onchain_swap_target"`, `"onchain_wallet_transfer_incoming"`, `"onchain_wallet_transfer_outgoing"`, `"onchain_withdrawal"`, `"onchain_withdrawal_offset"`, `"orchestration_percentage_fee"`, `"partner_grant_reward"`, `"passthrough_gmv"`, `"passthrough_gmv_offset"`, `"payment_dispute"`, `"payment_dispute_adjustment"`, `"payment_dispute_fee"`, `"payment_dispute_reversal"`, `"payment_gross"`, `"payment_gross_reversal"`, `"payment_processing_fixed_fee"`, `"payment_processing_percentage_fee"`, `"payment_receivable_clearing"`, `"payment_receivable_reversal"`, `"payment_receivable_settlement"`, `"payment_referral"`, `"payment_referral_payable"`, `"payment_referral_refund"`, `"payment_referral_reversal"`, `"payment_refund"`, `"payment_refund_fee"`, `"payment_refund_reversal"`, `"payment_return_fee"`, `"payment_revshare"`, `"payment_revshare_payout"`, `"payment_revshare_refund"`, `"payment_revshare_reversal"`, `"payment_unreconciled_clearing"`, `"payment_unreconciled_reversal"`, `"payout_fee"`, `"payout_receivable"`, `"payout_subsidy"`, `"payout_unreconciled_clearing"`, `"platform_affiliate_payment"`, `"platform_affiliate_payment_reversal"`, `"platform_balance_payment"`, `"platform_balance_payment_refund"`, `"platform_balance_transfer_fee"`, `"platform_balance_transfer_incoming"`, `"platform_balance_transfer_outgoing"`, `"platform_covered_dispute"`, `"platform_credits_granted"`, `"platform_credits_payment"`, `"platform_credits_payment_refund"`, `"platform_earning"`, `"platform_earning_settlement"`, `"platform_earning_unreconciled_clearing"`, `"platform_markup_fee"`, `"platform_markup_fee_payout"`, `"promo_reversal"`, `"psp_accelerated_settlement_fee"`, `"psp_account_debit"`, `"psp_account_updater_fee"`, `"psp_adjusted_processing_fee"`, `"psp_authentication_fee"`, `"psp_bank_pull_clearing"`, `"psp_bank_pull_settlement"`, `"psp_billing_fee"`, `"psp_clawback_fee"`, `"psp_clawback_settlement"`, `"psp_clawback_settlement_reversal"`, `"psp_collection_settlement"`, `"psp_commission_fee"`, `"psp_connect_fee"`, `"psp_correction"`, `"psp_currency_conversion_incoming"`, `"psp_currency_conversion_outgoing"`, `"psp_currency_conversion_receivable"`, `"psp_currency_conversion_receivable_clearing"`, `"psp_dispute_alert_fee"`, `"psp_dispute_fee"`, `"psp_dispute_management_fee"`, `"psp_dispute_payable"`, `"psp_external_account_connection_fee"`, `"psp_fixed_fee"`, `"psp_fx_adjustment"`, `"psp_gateway_fee"`, `"psp_identity_verification_fee"`, `"psp_interchange_fee"`, `"psp_invoice_tax_fee"`, `"psp_invoicing_fee"`, `"psp_markup_fee"`, `"psp_network_token_fee"`, `"psp_optimization_fee"`, `"psp_payin_clearing"`, `"psp_payin_settlement"`, `"psp_payment_method_fee"`, `"psp_payment_receivable"`, `"psp_payout_consolidation"`, `"psp_payout_deposit"`, `"psp_payout_fee"`, `"psp_payout_receivable"`, `"psp_payout_receivable_clearing"`, `"psp_payout_settlement"`, `"psp_payout_settlement_reversal"`, `"psp_pool_clearing"`, `"psp_pool_dispute_settlement"`, `"psp_pool_refund_clearing"`, `"psp_pool_refund_settlement"`, `"psp_pool_settlement"`, `"psp_processing_fee"`, `"psp_receivable_pooled"`, `"psp_recipient_wallet_load"`, `"psp_refund_fee"`, `"psp_refund_payable"`, `"psp_reserve_hold"`, `"psp_reserve_release"`, `"psp_risk_fee"`, `"psp_scheme_fee"`, `"psp_service_fee"`, `"psp_tax_filing_fee"`, `"psp_tax_service_fee"`, `"psp_terminal_fee"`, `"psp_transfer_settlement"`, `"psp_transfer_settlement_reversal"`, `"psp_treasury_fee"`, `"psp_variable_fee"`, `"psp_withholding_tax"`, `"recipient_wallet_load"`, `"referral_bonus"`, `"refund_payable_clearing"`, `"refund_payable_reversal"`, `"refund_settlement"`, `"refund_settlement_reversal"`, `"refund_unreconciled_clearing"`, `"refund_unreconciled_reversal"`, `"resolution_center_refund"`, `"revshare_percentage_fee"`, `"sales_tax_collected"`, `"sales_tax_collected_reversal"`, `"sales_tax_fee"`, `"sales_tax_remittance"`, `"sales_tax_remittance_reversal"`, `"sales_tax_remitted"`, `"settlement_rounding_variance"`, `"settlement_shortfall_loss"`, `"software_rental_revshare"`, `"software_rental_transaction"`, `"stripe_domestic_processing_fee"`, `"stripe_international_processing_fee"`, `"swap_fee"`, `"tax_filing_fee"`, `"three_ds_fixed_fee"`, `"topup"`, `"topup_fee"`, `"topup_reversal"`, `"trading_account_deposit"`, `"trading_account_deposit_offset"`, `"trading_account_withdrawal"`, `"trading_account_withdrawal_offset"`, `"treasury_fee"`, `"treasury_payin"`, `"treasury_payin_receivable"`, `"whop_processing_fee"`, `"whop_swap_fee_received"`, `"withdrawal_clawback"`, `"withdrawal_clawback_reversal"`, `"withdrawal_fee"`, `"withdrawal_fee_reversal"`, `"withdrawal_markup_fee"`, `"withdrawal_markup_fee_payout"`, `"withdrawal_markup_fee_payout_reversal"`, `"withdrawal_markup_fee_reversal"`, `"withdrawal_payable"`, `"withdrawal_payable_clearing"`, `"withdrawal_payable_clearing_reversal"`, `"withdrawal_payable_reversal"`, `"withdrawal_reclassification"`, `"withdrawal_reversal"`, `"withdrawal_topup_adjustment"`, `"deposit"`, `"wallet_transfer_incoming"`, `"wallet_transfer_outgoing"`, `"swap_source"`, `"swap_target"` 중 하나입니다.

**amount** `string` *required*

통화의 최소 정밀도 단위로 표시한 부호 있는 금액입니다.

**usd\_amount** `string | null` *required*

이 거래의 달러 가치를 10진수 문자열로 나타내며, `amount`와 같은 부호를 가집니다. 항목이 기록된 시점의 환율로 기록 금액에서 환산되며(지갑 잔액 차트 및 재무 보고서와 같은 가격 기준), 따라서 암호화폐 행에도 달러 가치가 포함됩니다. Whop이 환율을 보유하지 않은 통화의 경우 `null`입니다.

**currency** `object` *required*

이 원장 활동의 통화입니다.

**속성**

**code** `string` *required*

**precision** `string` *required*

**posted\_at** `string` *required*

활동이 원장에 기록된 시각입니다.

**available\_at** `string | null` *required*

이 활동이 사용 가능한 자금에 영향을 주는 시점의 ISO 8601 타임스탬프입니다. 대기 중인 확정 자금 해제 버킷의 입금 및 출금은 예정된 해제일의 00:00:00 UTC이고, 환불, 분쟁, 지급을 포함하여 정산된 사용 가능 자금에 대한 입금 및 출금은 기록 시각입니다. 온체인 행을 포함하여 이러한 경로 밖의 활동은 Null입니다. available\_after/before 필터는 이 값의 UTC 날짜를 사용합니다. 기본 활동에서는 옵트인 적립금을 포함한 일부 거래가 제외됩니다.

**resource** `object | null` *required*

이 원장 활동과 연결된 리소스입니다.

**형태 1**

**object** `"account"` *required*

**id** `string` *required*

**title** `string | null` *required*

**route** `string | null` *required*

**logo\_url** `string | null` *required*

**형태 2**

**object** `"user"` *required*

**id** `string` *required*

**name** `string | null` *required*

**username** `string | null` *required*

**profile\_picture\_url** `string | null` *required*

**형태 3**

**object** `"bounty"` *required*

**id** `string` *required*

**title** `string` *required*

**status** `string` *required*

**형태 4**

**object** `"ledger_account"` *required*

**id** `string` *required*

**owner** `object | null` *required*

**형태 1**

**object** `"account"` *required*

**id** `string` *required*

**title** `string | null` *required*

**route** `string | null` *required*

**logo\_url** `string | null` *required*

**형태 2**

**object** `"user"` *required*

**id** `string` *required*

**name** `string | null` *required*

**username** `string | null` *required*

**profile\_picture\_url** `string | null` *required*

**형태 5**

**object** `"payment_method"` *required*

**id** `string` *required*

**payment\_method\_type** `string | null` *required*

**gateway\_type** `string | null` *required*

**card** `object | null` *required*

**속성**

**brand** `string | null` *required*

**last4** `string | null` *required*

**exp\_month** `number | null` *required*

**exp\_year** `number | null` *required*

**bank** `object | null` *required*

**속성**

**bank\_name** `string | null` *required*

**account\_name** `string | null` *required*

**last4** `string | null` *required*

**account\_type** `string | null` *required*

**email\_identifier** `string | null` *required*

**형태 6**

**object** `"payout_method"` *required*

**id** `string` *required*

**nickname** `string | null` *required*

**institution\_name** `string | null` *required*

**account\_reference** `string | null` *required*

**provider** `string | null` *required*

**destination\_currency\_code** `string | null` *required*

**형태 7**

**object** `"card_transaction"` *required*

**id** `string` *required*

**card\_id** `string | null` *required*

**merchant\_name** `string | null` *required*

**merchant\_icon\_url** `string | null` *required*

**merchant\_category** `string | null` *required*

**status** `string | null` *required*

**usd\_amount** `string | null` *required*

**local\_amount** `string | null` *required*

**local\_currency** `string | null` *required*

**cashback\_usd** `string | null` *required*

**levels\_points** `string | null` *required*

**authorized\_at** `string | null` *required*

**posted\_at** `string | null` *required*

**declined\_reason** `string | null` *required*

**source** `object | null` *required*

이 원장 활동의 출처입니다. 플랫폼 마크업 수수료는 object platform\_fee와 원장 활동 ID를 사용합니다.

**속성**

**object** `string` *required*

**id** `string` *required*

**fee\_kind** `string | null`

`"deposit"`, `"transfer"`, `"card_spend"`, `"payout"`, `"swap"`, `null` 중 하나입니다.

**status** `string | null`

**payment\_amount** `Money | null`

**속성**

**currency** `string` *required*

소문자로 된 세 글자 ISO 4217 통화 코드입니다.

**amount** `string` *required*

주 단위 금액을 정확한 10진수 문자열로 나타냅니다. `"10.00"`은 10달러입니다. 전송 중에 부동 소수점 반올림이 일어나지 않도록 문자열을 사용합니다.

**decimals** `number` *required*

금액이 실제로 가지는 소수 자릿수로, 청구 자체에 적용되는 정밀도입니다.

**display\_decimals** `number` *required*

표시할 소수 자릿수입니다. 보통 `decimals`와 같지만 의도적으로 항상 같지는 않습니다. COP는 센타보 단위로 청구되지만 페소 단위로 표기되므로 각각 `2`와 `0`입니다. 이 값을 사용하여 자체 로케일로 숫자를 포맷하세요.

**payment\_method\_type** `string | null`

**payment\_processor** `string | null`

**card\_brand** `string | null`

**reason** `string | null`

**notes** `string | null`

**risk\_review\_hold** `boolean | null`

**claim\_url** `string | null`

**amount\_float** `number | null`

**payout\_amount** `Money | null`

**속성**

**currency** `string` *required*

소문자로 된 세 글자 ISO 4217 통화 코드입니다.

**amount** `string` *required*

주 단위 금액을 정확한 10진수 문자열로 나타냅니다. `"10.00"`은 10달러입니다. 전송 중에 부동 소수점 반올림이 일어나지 않도록 문자열을 사용합니다.

**decimals** `number` *required*

금액이 실제로 가지는 소수 자릿수로, 청구 자체에 적용되는 정밀도입니다.

**display\_decimals** `number` *required*

표시할 소수 자릿수입니다. 보통 `decimals`와 같지만 의도적으로 항상 같지는 않습니다. COP는 센타보 단위로 청구되지만 페소 단위로 표기되므로 각각 `2`와 `0`입니다. 이 값을 사용하여 자체 로케일로 숫자를 포맷하세요.

**fee\_amount** `Money | null`

**속성**

**currency** `string` *required*

소문자로 된 세 글자 ISO 4217 통화 코드입니다.

**amount** `string` *required*

주 단위 금액을 정확한 10진수 문자열로 나타냅니다. `"10.00"`은 10달러입니다. 전송 중에 부동 소수점 반올림이 일어나지 않도록 문자열을 사용합니다.

**decimals** `number` *required*

금액이 실제로 가지는 소수 자릿수로, 청구 자체에 적용되는 정밀도입니다.

**display\_decimals** `number` *required*

표시할 소수 자릿수입니다. 보통 `decimals`와 같지만 의도적으로 항상 같지는 않습니다. COP는 센타보 단위로 청구되지만 페소 단위로 표기되므로 각각 `2`와 `0`입니다. 이 값을 사용하여 자체 로케일로 숫자를 포맷하세요.

**fee\_type** `"exclusive" | "inclusive" | null`

**created\_by\_user** `UserSummary | null`

**속성**

**id** `string` *required*

`user_` 접두사가 붙은 사용자 ID입니다.

**username** `string` *required*

공개 사용자 이름입니다.

**name** `string | null` *required*

표시 이름입니다.

**profile\_picture** `UserProfilePicture` *required*

아바타 래퍼입니다. `url`은 항상 존재하며, 사용자가 사진을 설정하지 않은 경우 생성된 플레이스홀더를 사용합니다.

**속성**

**url** `string` *required*

아바타 이미지 URL입니다. 항상 존재하며, 사용자가 사진을 설정하지 않은 경우 생성된 플레이스홀더입니다.

**trace\_code** `string | null`

**created\_at** `string | null`

**estimated\_arrival** `string | null`

**payer\_name** `string | null`

**payout\_token\_nickname** `string | null`

**tx\_hash** `string | null`

**sender\_address** `string | null`

**chain** `string | null`

**from\_amount** `string | null`

**from\_currency** `string | null`

**to\_amount** `string | null`

**to\_currency** `string | null`

**payout\_destination** `object | null`

**속성**

**payer\_name** `string | null`

**icon\_url** `string | null`

**security\_answer** `string | null`

**\[key: string]** `unknown` *required*

**payment** `object | null`

이 원장 활동과 관련된 결제입니다. 리치 리소스 하이드레이션이 활성화되어 있고 거래가 결제와 연결된 경우에 포함됩니다.

**속성**

**object** `"payment"` *required*

**id** `string` *required*

**amount** `Money | null` *required*

**속성**

**currency** `string` *required*

소문자로 된 세 글자 ISO 4217 통화 코드입니다.

**amount** `string` *required*

주 단위 금액을 정확한 10진수 문자열로 나타냅니다. `"10.00"`은 10달러입니다. 전송 중에 부동 소수점 반올림이 일어나지 않도록 문자열을 사용합니다.

**decimals** `number` *required*

금액이 실제로 가지는 소수 자릿수로, 청구 자체에 적용되는 정밀도입니다.

**display\_decimals** `number` *required*

표시할 소수 자릿수입니다. 보통 `decimals`와 같지만 의도적으로 항상 같지는 않습니다. COP는 센타보 단위로 청구되지만 페소 단위로 표기되므로 각각 `2`와 `0`입니다. 이 값을 사용하여 자체 로케일로 숫자를 포맷하세요.

**payment\_method\_type** `string | null` *required*

**payment\_processor** `string | null` *required*

**card\_brand** `string | null` *required*

**card\_last4** `string | null` *required*

**user** `object | null` *required*

**속성**

**id** `string` *required*

**name** `string` *required*

**email** `string | null` *required*

**product** `object | null` *required*

**속성**

**id** `string` *required*

**name** `string` *required*

**plan** `object | null` *required*

**속성**

**id** `string` *required*

**name** `string | null` *required*

**created\_at** `string` *required*

**payment\_id** `string | null`

환불 및 분쟁을 포함한 모든 결제 관련 활동의 결제 ID입니다.

**user\_id** `string | null`

결제와 연결된 고객의 ID입니다.

**user\_name** `string | null`

결제와 연결된 고객의 표시 이름입니다.

**user\_email** `string | null`

결제와 연결된 고객의 이메일입니다. member:email:read가 필요합니다.

**product\_id** `string | null`

해당하는 경우 결제와 연결된 상품의 ID입니다.

**product\_name** `string | null`

해당하는 경우 결제와 연결된 상품의 이름입니다.

**plan\_id** `string | null`

해당하는 경우 결제와 연결된 옵션의 ID입니다.

**plan\_name** `string | null`

해당하는 경우 결제와 연결된 옵션의 이름입니다.

**account** `object`

이 행의 원장을 소유한 뷰어 계정입니다. 응답이 소유 계정을 집계하는 경우(include\_owned\_accounts=true)에만 존재하며, 그 외에는 생략됩니다.

**형태 1**

**object** `"account"` *required*

**id** `string` *required*

**title** `string | null` *required*

**route** `string | null` *required*

**logo\_url** `string | null` *required*

**형태 2**

**object** `"user"` *required*

**id** `string` *required*

**name** `string | null` *required*

**username** `string | null` *required*

**profile\_picture\_url** `string | null` *required*

**ledger\_account\_id** `string | null`

이 행이 속한 원장 계정(ldgr\_ 식별자)입니다. 응답이 소유 계정을 집계하는 경우(include\_owned\_accounts=true)에만 존재하며, 그 외에는 생략됩니다. `account`와 함께 사용하여 드로어와 대시보드 링크의 범위를 소유 비즈니스로 지정하세요.

### `onSeeAllRequested`

뷰어가 `maxItems` 목록에서 See all activity를 눌렀습니다. 자체 전체 활동 화면을 여세요. 엘리먼트는 절대 페이지를 이동하지 않습니다.

### `onDateRangeChanged`

뷰어가 `setDateRange`가 아닌 필터 칩을 통해 날짜 필터를 변경했습니다. 차트 브러시처럼 더 이상 일치하지 않는 자체 범위 선택을 지우세요.

**payload** `object`

**속성**

**dateRange** `object | null` *required*

**속성**

**start** `string` *required*

**end** `string` *required*

### `onLoaderStart`

로딩 스켈레톤이 처음 그려진 후, `onReady` 전에 실행됩니다.

### `onReady`

엘리먼트가 처음으로 완전히 그려진 후 실행됩니다.

### `onError`

엘리먼트가 로드에 실패하거나 충돌할 때 실행됩니다. 대체 화면은 계속 표시됩니다. 프로그래밍 방식으로 처리하려면 `code`를 사용하세요. `sourceKey`는 실패한 호스트 상태 소스를 식별합니다.

**e** `object`

**속성**

**message** `string` *required*

**code** `string`

**sourceKey** `string`

## 메서드

`create`가 반환한 핸들에서, 또는 React `ref`를 통해 호출합니다.

### `refresh`

계정의 활동을 첫 페이지부터 다시 가져옵니다. 다른 곳에서 변경(입금, 송금)이 일어난 후 호출하면 캐시가 만료될 때까지 기다리지 않고 목록에 반영됩니다.

**반환값** `Promise<void>`

### `setDateRange`

엘리먼트 외부에서 날짜 필터를 설정합니다. 예를 들어 차트 브러시 선택을 목록에 연결할 수 있습니다. 지우려면 `null`을 전달하세요.

**매개변수**

**input** `ActivityDateRangeOverride | null` *required*

**속성**

**start** `string` *required*

**end** `string` *required*

**includeTime** `boolean`

**postedAfter** `string`

**postedBefore** `string`

**displayPostedAfter** `string`

**displayPostedBefore** `string`

**반환값** `Promise<void>`

### `mount`

`target`에 엘리먼트를 마운트하고 로딩을 시작합니다. React 컴포넌트는 자동으로 마운트됩니다.

**매개변수**

**target** `string | HTMLElement` *required*

### `destroy`

엘리먼트를 제거하고 프레임과 구독을 해제합니다. 여러 번 호출해도 됩니다. React는 엘리먼트를 자동으로 제거합니다.

### `update`

마운트된 엘리먼트에 새 props를 병합합니다. React에서는 대신 컴포넌트 props를 변경하세요.

**매개변수**

**options** `Partial\<ActivityElementProps\>` *required*

## 스타일링

`appearance.classes`를 통해 다음 부분의 스타일을 지정합니다. 속성 이름은 카멜 케이스 또는 케밥 케이스를 사용하고 단위를 포함하세요. 페이지 스타일시트는 엘리먼트의 프레임에 적용되지 않습니다. 프레임워크는 각 선언을 삽입하기 전에 유효성을 검사합니다.

| 클래스 | 대상 |
| - | - |
| `.whop-ActivityRow` | 원장 활동 행 하나: 아이콘, 제목, 타임스탬프, 금액 |
| `.whop-ActivitySurface` | 활동 피드: 제목, 필터, 가져온 모든 행 |

```ts theme={null}
const wallet = whop.wallet.create({
  appearance: {
    classes: {
      'whop-ActivityRow': { borderRadius: '8px', fontWeight: '600' },
      'whop-ActivitySurface': { borderRadius: '8px', fontWeight: '600' }
    }
  }
});

wallet.update({
  appearance: { classes: { 'whop-ActivityRow': { fontWeight: '700' } } }
});
```

React에서는 `appearance`를 `<Wallet>`에 전달합니다. 전역으로 설정하려면 `WhopElements({ appearance })`를 사용하세요.

## 매개변수

**accountId** `String` *required*

목록을 표시할 원장의 소유자입니다. `biz_` 접두사가 붙은 계정 ID 또는 `user_` 접두사가 붙은 사용자 ID를 사용하세요. 피드는 원장을 먼저 확인하지 않고 ID를 읽으므로 둘 다 바로 작동합니다.

**showsTitle** `Bool`

기본 제공 "Activity" 제목을 표시합니다. 기본값은 `true`입니다. 화면에 이미 제목이 있다면 끄세요.

**onActivitySelected** `((WalletActivity) -\> Void)?`

뷰어가 탭한 행과 함께 호출됩니다. 뷰는 절대 페이지를 이동하지 않으므로 자체 상세 화면으로 라우팅하세요.

## `WalletActivity`

선택 시 반환되는 값:

* `id: String`: 행마다 안정적인 값
* `title: String` / `subtitle: String`: 행의 두 줄
* `amount: Decimal`: 부호 있는 값이며, 나가는 돈은 음수
* `currencyCode: String`
* `postedAt: Date`
* `isIncoming: Bool`

## 상태

첫 페이지가 로드되는 동안 스켈레톤 목록을, 원장에 거래가 없으면 `No activity found`를, 읽기에 실패하면 실패 메시지와 `Try again` 버튼을 표시합니다. 이후 페이지 로드에 실패하면 이미 로드된 행은 화면에 남고 하단에 `Try again`이 표시됩니다.

## 알아두면 좋은 점

* **스크롤 컨테이너 안에 두세요.** 피드는 `LazyVStack`이며 마지막 행이 나타날 때 다음 페이지를 불러오므로, `ScrollView` 밖에서는 첫 페이지만 렌더링하고 다른 페이지를 로드하지 않습니다.
* `biz_…` 및 `user_…` 태그를 직접 받으므로, 다른 지갑 뷰와 달리 원장을 먼저 확인할 필요가 없습니다.

> [!NOTE]
>
> 앱 실행 시 `WhopSDK.configure(tokenProvider:)`를 한 번 호출하세요. 뷰는 토큰을 기다립니다. [시작하기](https://docs.whop.com/ko/elements/latest/getting-started.md)를 참고하세요. 테마는 `.whopTheme(_:)`로 적용합니다.


## Related topics

- [Elements 시작하기](https://docs.whop.com/ko/elements/latest/getting-started.md)
- [하위 계정 지급 활성화](https://docs.whop.com/ko/developer/platforms/render-payout-portal.md)
- [잔액](https://docs.whop.com/ko/elements/latest/wallet/balances.md)
