> ## 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.

# Financial Activity API

> Financial Activity 행은 계정 또는 사용자 잔액에 들어오거나 나가는 단일 자금 이동입니다. 결제, 지급, 환불, 이체, 온체인 입금, 스왑 또는 카드 거래가 해당됩니다.

각 행에는 유형이 지정된 `resource`와 `source`가 포함되어 있어 추가 조회 없이 이벤트를 표시하고 연결할 수 있습니다.

Financial Activity API를 사용하여 계정 또는 사용자의 명세서나 거래 피드를 만들고, 재무 보고서로 특정 기간의 잔액 활동, 수입, 잔액을 요약한 다음, 보고서 합계를 그 원인별로 세분화할 수 있습니다.

## 엔드포인트

| 엔드포인트 | 요청 |
| - | - |
| [Financial Activity 목록 조회](https://docs.whop.com/ko/api-reference/ledgers/list-financial-activity.md) | GET `/financial_activity` |
| [재무 보고서 조회](https://docs.whop.com/ko/api-reference/ledgers/get-financial-report.md) | GET `/financial_reports` |
| [재무 보고서 세부 내역 조회](https://docs.whop.com/ko/api-reference/ledgers/get-financial-report-breakdown.md) | GET `/financial_reports/breakdown` |

## 속성

**id** `string` *required*

원장 활동 ID입니다.

**account** `account or user`

이 행의 원장을 소유한 조회자 계정입니다. 응답이 소유 계정을 집계하는 경우(include\_owned\_accounts=true)에만 포함되며, 그 외에는 생략됩니다.

**amount** `string` *required*

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

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

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

**currency** `object` *required*

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

> [accordion] 속성
>
> **code** `string` *required*
>
> 통화 코드입니다.
>
> **precision** `string` *required*
>
> 통화의 정밀도 계수입니다(예: USD의 경우 `100000000`).

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

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

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

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

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

**object** `string` *required*

**payment** `payment | null`

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

> [accordion] 속성
>
> **id** `string` *required*
>
> 결제 ID이며, `pay_` 접두사로 시작합니다.
>
> **amount** `object | null` *required*
>
> 결제로 청구된 총액입니다.
>
> > [accordion] 속성
> >
> > **amount** `string` *required*
> >
> > 주 단위 금액이며, 정확한 십진수 문자열입니다. 예를 들어 `"10.00"`은 10달러입니다. 전송 중 부동소수점 반올림이 발생하지 않도록 문자열로 제공됩니다.
> >
> > **currency** `string` *required*
> >
> > 소문자로 된 세 글자 ISO 4217 통화 코드입니다.
> >
> > **decimals** `integer` *required*
> >
> > 금액이 갖는 소수 자릿수입니다. 실제 결제가 처리되는 정밀도입니다.
> >
> > **display\_decimals** `integer` *required*
> >
> > 표시할 소수 자릿수입니다. 일반적으로 `decimals`와 같지만, 의도적으로 항상 같지는 않습니다. COP는 센타보 단위로 청구되지만 페소 단위로 표기되므로 각각 `2`와 `0`입니다. 이 값을 사용하여 사용자의 로캘에 맞게 숫자를 포맷하세요.
>
> **card\_brand** `string | null` *required*
>
> 고객이 카드로 결제한 경우의 카드 브랜드입니다.
>
> **card\_last4** `string | null` *required*
>
> 고객이 카드로 결제한 경우의 카드 마지막 네 자리입니다.
>
> **created\_at** `string` *required*
>
> 결제가 생성된 시각입니다.
>
> **object** `string` *required*
>
> **payment\_method\_type** `string | null` *required*
>
> 고객의 결제 방법입니다(예: `card` 또는 `paypal`).
>
> **payment\_processor** `string | null` *required*
>
> 결제를 처리한 프로세서입니다(예: `stripe`).
>
> **plan** `object | null` *required*
>
> 해당되는 경우, 결제와 연결된 변형입니다.
>
> > [accordion] 속성
> >
> > **id** `string` *required*
> >
> > 변형 ID이며, `plan_` 접두사로 시작합니다.
> >
> > **name** `string | null` *required*
> >
> > 변형 이름입니다.
>
> **product** `object | null` *required*
>
> 해당되는 경우, 결제와 연결된 상품입니다.
>
> > [accordion] 속성
> >
> > **id** `string` *required*
> >
> > 상품 ID이며, `prod_` 접두사로 시작합니다.
> >
> > **name** `string` *required*
> >
> > 상품 이름입니다.
>
> **user** `object | null` *required*
>
> 결제와 연결된 고객입니다. 이메일은 member:email:read 권한이 필요합니다.
>
> > [accordion] 속성
> >
> > **id** `string` *required*
> >
> > 고객 ID이며, `user_` 접두사로 시작합니다.
> >
> > **email** `string | null` *required*
> >
> > 고객 이메일이며, member:email:read 권한이 없으면 null입니다.
> >
> > **name** `string` *required*
> >
> > 고객 표시 이름입니다.

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

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

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

해당되는 경우, 결제와 연결된 변형의 ID입니다.

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

해당되는 경우, 결제와 연결된 변형의 이름입니다.

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

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

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

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

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

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

**resource** `account or user or bounty or ledger_account or payment_method or payout_method or card_transaction | null` *required*

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

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

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

> [accordion] 속성
>
> **id** `string` *required*
>
> **amount\_float** `number | null`
>
> 대상 통화로 표시된 십진수 지급 금액입니다(payout 출처에만 해당, payout:withdrawal:read 필요).
>
> **card\_brand** `string | null`
>
> 결제 출처에서 사용된 카드 브랜드입니다.
>
> **chain** `string | null`
>
> 입금이 도착한 체인입니다(예: plasma, onchain\_transaction 출처에만 해당).
>
> **claim\_url** `string | null`
>
> 에어드롭의 수령 URL입니다. 호출자가 자금 제공 계정의 수령 링크를 관리하거나 자금 제공 개인 잔액에서 출금할 수 있는 경우가 아니면 Null입니다.
>
> **created\_at** `string | null`
>
> 지급 생성 시각이며, ISO 8601 타임스탬프입니다(payout 출처에만 해당, payout:withdrawal:read 필요).
>
> **created\_by\_user** `object | null`
>
> 출금을 요청한 사용자입니다. 시스템에서 생성된 출금이거나 payout:withdrawal:read 권한이 없으면 Null입니다.
>
> > [accordion] 속성
> >
> > **id** `string` *required*
> >
> > 사용자 ID이며, `user_` 접두사로 시작합니다.
> >
> > **name** `string | null` *required*
> >
> > 표시 이름입니다.
> >
> > **profile\_picture** `object` *required*
> >
> > 아바타 래퍼입니다. `url`은 항상 존재하며, 사용자가 사진을 설정하지 않은 경우 생성된 플레이스홀더입니다.
> >
> > > [accordion] 속성
> > >
> > > **url** `string` *required*
> > >
> > > 아바타 이미지 URL입니다. 항상 존재합니다. 사용자가 사진을 설정하지 않은 경우 생성된 플레이스홀더입니다.
> >
> > **username** `string` *required*
> >
> > 공개 사용자 이름입니다.
>
> **estimated\_arrival** `string | null`
>
> 예상 도착 시각이며, ISO 8601 타임스탬프입니다(payout 출처에만 해당, payout:withdrawal:read 필요).
>
> **fee\_amount** `object | null`
>
> 마크업 수수료를 포함한 총 출금 수수료입니다. payout:withdrawal:read가 필요합니다.
>
> > [accordion] 속성
> >
> > **amount** `string` *required*
> >
> > 주 단위 금액이며, 정확한 십진수 문자열입니다. 예를 들어 `"10.00"`은 10달러입니다. 전송 중 부동소수점 반올림이 발생하지 않도록 문자열로 제공됩니다.
> >
> > **currency** `string` *required*
> >
> > 소문자로 된 세 글자 ISO 4217 통화 코드입니다.
> >
> > **decimals** `integer` *required*
> >
> > 금액이 갖는 소수 자릿수입니다. 실제 결제가 처리되는 정밀도입니다.
> >
> > **display\_decimals** `integer` *required*
> >
> > 표시할 소수 자릿수입니다. 일반적으로 `decimals`와 같지만, 의도적으로 항상 같지는 않습니다. COP는 센타보 단위로 청구되지만 페소 단위로 표기되므로 각각 `2`와 `0`입니다. 이 값을 사용하여 사용자의 로캘에 맞게 숫자를 포맷하세요.
>
> **fee\_kind** `string | null`
>
> 플랫폼 마크업 수수료를 발생시킨 작업입니다: deposit, swap, transfer, card\_spend 또는 payout. include\_resource가 false인 경우를 포함하여 platform\_markup\_fee 및 platform\_markup\_fee\_payout에 포함됩니다. 원래 작업을 확인할 수 없으면 Null이며, 다른 출처 유형에서는 생략됩니다.
>
> 사용 가능한 옵션: `payout`, `transfer`, `deposit`, `swap`, `card_spend`
>
> **fee\_type** `string | null`
>
> 출금 수수료가 포함 방식인지 별도 방식인지 여부입니다. payout:withdrawal:read가 필요합니다.
>
> 사용 가능한 옵션: `exclusive`, `inclusive`
>
> **from\_amount** `string | null`
>
> from\_currency에서 전환된 금액이며, 십진수 문자열입니다(swap 출처에만 해당).
>
> **from\_currency** `string | null`
>
> 전환 전 통화의 소문자 통화 코드입니다(swap 출처에만 해당).
>
> **notes** `string | null`
>
> transfer, payout 또는 bank\_deposit 출처에 첨부된 메모이며, 제공되지 않은 경우 null입니다(payout 출처에서는 payout:withdrawal:read 필요).
>
> **object** `string` *required*
>
> **payer\_name** `string | null`
>
> payout 출처에서는 지급을 처리하는 기관의 이름입니다(payout:withdrawal:read 필요). bank\_deposit 출처에서는 입금을 보낸 계좌의 이름입니다.
>
> **payment\_amount** `object | null`
>
> 결제 출처에서 청구된 총액입니다.
>
> > [accordion] 속성
> >
> > **amount** `string` *required*
> >
> > 주 단위 금액이며, 정확한 십진수 문자열입니다. 예를 들어 `"10.00"`은 10달러입니다. 전송 중 부동소수점 반올림이 발생하지 않도록 문자열로 제공됩니다.
> >
> > **currency** `string` *required*
> >
> > 소문자로 된 세 글자 ISO 4217 통화 코드입니다.
> >
> > **decimals** `integer` *required*
> >
> > 금액이 갖는 소수 자릿수입니다. 실제 결제가 처리되는 정밀도입니다.
> >
> > **display\_decimals** `integer` *required*
> >
> > 표시할 소수 자릿수입니다. 일반적으로 `decimals`와 같지만, 의도적으로 항상 같지는 않습니다. COP는 센타보 단위로 청구되지만 페소 단위로 표기되므로 각각 `2`와 `0`입니다. 이 값을 사용하여 사용자의 로캘에 맞게 숫자를 포맷하세요.
>
> **payment\_method\_type** `string | null`
>
> 결제 출처에서 사용된 결제 수단입니다. bank\_deposit 출처에서는 이체 방식인 `wire`, `ach` 또는 `rtp`입니다.
>
> **payment\_processor** `string | null`
>
> 결제 출처에서 사용된 프로세서입니다.
>
> **payout\_amount** `object | null`
>
> 수수료를 제외하고 대상에 전송된 출금 원금이며, 출금 통화 기준입니다. payout:withdrawal:read가 필요합니다.
>
> > [accordion] 속성
> >
> > **amount** `string` *required*
> >
> > 주 단위 금액이며, 정확한 십진수 문자열입니다. 예를 들어 `"10.00"`은 10달러입니다. 전송 중 부동소수점 반올림이 발생하지 않도록 문자열로 제공됩니다.
> >
> > **currency** `string` *required*
> >
> > 소문자로 된 세 글자 ISO 4217 통화 코드입니다.
> >
> > **decimals** `integer` *required*
> >
> > 금액이 갖는 소수 자릿수입니다. 실제 결제가 처리되는 정밀도입니다.
> >
> > **display\_decimals** `integer` *required*
> >
> > 표시할 소수 자릿수입니다. 일반적으로 `decimals`와 같지만, 의도적으로 항상 같지는 않습니다. COP는 센타보 단위로 청구되지만 페소 단위로 표기되므로 각각 `2`와 `0`입니다. 이 값을 사용하여 사용자의 로캘에 맞게 숫자를 포맷하세요.
>
> **payout\_destination** `object | null`
>
> 지급 대상 표시 정보입니다(payout 출처에만 해당).
>
> > [accordion] 속성
> >
> > **icon\_url** `string | null`
> >
> > **payer\_name** `string | null`
> >
> > **security\_answer** `string | null`
> >
> > 판매자가 이 지급 수단(예: Interac e-Transfer)을 추가할 때 설정한 보안 답변으로, 지급을 수령하는 데 필요합니다. 대상에 사용자 지정 답변이 없으면 null입니다. payout:destination:read가 필요합니다.
>
> **payout\_token\_nickname** `string | null`
>
> 저장된 지급 대상의 별칭입니다(payout 출처에만 해당).
>
> **reason** `string | null`
>
> 활동이 발생한 이유입니다. transfer 출처에서는 이체 사유입니다(예: pool\_top\_up 또는 bounty\_return). payout 출처에서는 지급이 취소, 거부 또는 실패한 이유를 설명하며(payout:withdrawal:read 필요), 지급이 정상적으로 진행 중인 동안에는 null입니다.
>
> **risk\_review\_hold** `boolean | null`
>
> 이 지급이 현재 수동 위험 검토를 위해 보류 중인지 여부입니다(payout 출처에만 해당, payout:withdrawal:read 필요).
>
> **sender\_address** `string | null`
>
> onchain\_transaction 출처에서는 발신 지갑 주소 또는 온램프 제공업체 식별자입니다. bank\_deposit 출처에서는 송금 은행 계좌의 마지막 네 자리입니다(예: `••••1547`).
>
> **status** `string | null`
>
> 수명 주기 상태입니다. payout 출처에서는 지급 상태이며(payout:withdrawal:read 필요), airdrop\_link 출처에서는 수령 링크 상태이고(제한 없음), payment 및 top-up 출처에서는 succeeded/pending/failed 같은 사용자 친화적 결제 상태이며(제한 없음), bank\_deposit 출처에서는 succeeded, reversal\_in\_progress 또는 reversed입니다(제한 없음).
>
> **to\_amount** `string | null`
>
> to\_currency로 받은 금액이며, 십진수 문자열입니다(swap 출처에만 해당).
>
> **to\_currency** `string | null`
>
> 전환 후 통화의 소문자 통화 코드입니다(swap 출처에만 해당).
>
> **trace\_code** `string | null`
>
> 출금에 대한 은행 추적 참조 번호입니다. payout:withdrawal:read가 필요합니다.
>
> **tx\_hash** `string | null`
>
> 온체인 트랜잭션 해시입니다(onchain\_transaction 및 swap 출처에만 해당).

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

이 이동의 달러 가치이며, `amount`와 같은 부호를 갖는 십진수 문자열입니다. 라인이 기록될 당시의 환율로 기록 금액을 환산한 값으로, 지갑 잔액 차트와 재무 보고서가 사용하는 것과 동일한 가격 기준이므로 암호화폐 행에도 달러 가치가 포함됩니다. Whop이 환율을 보유하지 않은 통화의 경우 `null`입니다.

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

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

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

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

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

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

```json LedgerActivity theme={null}
{
	"id": "line_cGF5bWVudF9ncm9zczpsaTpwZXRhbHBvc3Q6YWM6bGVkZ2VyOmxlOjE6djppazpyZWNlaXB0",
	"object": "ledger_activity",
	"line_type": "payment_gross",
	"amount": "4800000000",
	"usd_amount": "48.0",
	"currency": {
		"code": "usd",
		"precision": "100000000"
	},
	"posted_at": "2026-06-14T18:49:49Z",
	"available_at": "2026-06-17T00:00:00Z",
	"resource": {
		"id": "user_4Hk2mZ9qLpXa",
		"object": "user",
		"name": "Jordan Avery",
		"username": "jordanavery",
		"profile_picture_url": "https://cdn.whop.com/users/jordan-avery.png"
	},
	"source": {
		"id": "pay_8QcR2mZ9qLpXa",
		"object": "payment"
	},
	"account": {
		"id": "biz_9dCwK2mZ9qLpXa",
		"object": "account",
		"title": "Acme Studios",
		"route": "acme-studios",
		"logo_url": "https://cdn.whop.com/companies/acme-studios.png"
	},
	"ledger_account_id": "ldgr_7bQx2mZ9qLpXa"
}
```

## 라인 유형 용어집

모든 활동 행에는 해당 행이 나타내는 금융 이벤트를 지정하는 `line_type`이 있습니다. [Financial Activity 목록 조회](https://docs.whop.com/ko/api-reference/ledgers/list-financial-activity.md)에 하나 이상의 `line_types`를 전달하여 특정 이벤트로 피드를 필터링할 수 있으며, 반복되는 `line_types[]` 파라미터 또는 쉼표로 구분된 단일 값(`line_types=payment_gross,payment_refund`)으로 전달합니다. 알 수 없는 라인 유형은 `400`을 반환합니다.

LPM(Local Payment Method)은 은행 자동이체, 은행 송금, 지갑을 포함한 카드 이외의 결제 수단을 의미합니다.

### 카테고리

개별 라인 유형을 나열하는 대신 카테고리 약칭을 전달할 수 있습니다. 카테고리는 포함된 모든 라인 유형으로 확장됩니다.

| 카테고리 | 확장 대상 |
| - | - |
| `fees` | 모든 처리 수수료 라인 유형입니다. 아래 [수수료](#fees) 섹션의 모든 항목이 포함됩니다. |

### 결제

| 라인 유형 | 설명 |
| - | - |
| `payment_gross` | 지갑에 정산되는 카드 또는 LPM 판매로, 수수료 차감 전 총액입니다. |
| `topup` | 상품 판매가 아닌, 계정이 자체 지갑 잔액에 추가한 자금입니다. |
| `platform_balance_payment` | 외부 카드나 LPM 대신 기존 지갑 잔액으로 결제한 구매입니다. |
| `passthrough_gmv` | Stripe Standard, PayPal, Coinbase Commerce 같은 외부 프로세서를 통해 이루어진 구매에 대해 기록된 총 상품 거래액(GMV)입니다. |
| `installment_default` | 구매자의 선구매 후결제(BNPL) 할부 연체를 충당하기 위한 지갑 청구입니다. |

### 환불

| 라인 유형 | 설명 |
| - | - |
| `payment_refund` | 지갑에서 차감되는 카드 또는 LPM 결제의 환불입니다. |
| `payment_refund_reversal` | `payment_refund`를 취소하여 자금을 지갑으로 반환합니다. |
| `platform_balance_payment_refund` | 지갑 잔액 구매의 환불로, 원래 구매자의 잔액으로 반환됩니다. |

### 분쟁

| 라인 유형 | 설명 |
| - | - |
| `payment_dispute` | 지갑에서 차감되는 카드 또는 LPM 결제의 지불 거절(chargeback)입니다. |
| `payment_dispute_adjustment` | 분쟁 금액이 원래 결제와 다를 때(부분 분쟁) 지불 거절을 조정하는 입금 또는 출금입니다. |
| `payment_dispute_reversal` | 판매자가 분쟁에서 승소한 후 `payment_dispute`를 취소합니다. |
| `platform_covered_dispute` | 판매에 구매자 수수료가 포함된 경우 Whop 마켓플레이스가 부담하는 지불 거절 금액 부분입니다. 입금 또는 출금일 수 있습니다. |
| `dispute_hold_adjustment` | 분쟁 보류로 자금을 이동하거나 보류에서 자금을 이동합니다. 출금은 보류를 설정하고, 입금은 보류를 해제합니다. |

### 적립금

| 라인 유형 | 설명 |
| - | - |
| `psp_reserve_hold` | 결제 프로세서가 정산금의 일부를 적립금으로 보류하여, 해제될 때까지 해당 자금을 사용할 수 없게 합니다. |
| `psp_reserve_release` | 결제 프로세서가 이전에 보류한 적립금을 사용 가능한 정산 잔액으로 반환합니다. |

### 지급

| 라인 유형 | 설명 |
| - | - |
| `withdrawal` | 지갑 자금을 외부 은행 계좌로 지급합니다(라인 유형은 기존 이름을 유지합니다). |
| `withdrawal_reversal` | 취소되거나 거부된 지급을 되돌리고 자금을 지갑으로 반환합니다. |
| `withdrawal_clawback` | 마이너스 잔액을 충당하기 위해 연결된 은행 계좌에서 자금을 회수하여 지갑에 입금합니다. |
| `withdrawal_clawback_reversal` | 회수가 나중에 실패하거나 은행이 자금을 반환할 때 `withdrawal_clawback`을 취소합니다. |
| `withdrawal_reclassification` | Whop이 지급을 내부 이체로 재분류할 때 지급의 순액을 지갑의 사용 가능 잔액으로 반환합니다. |

### 이체

| 라인 유형 | 설명 |
| - | - |
| `platform_balance_transfer_outgoing` | 지갑 자금을 플랫폼의 다른 계정으로 이체합니다. |
| `platform_balance_transfer_incoming` | 플랫폼의 다른 계정에서 지갑으로 자금을 이체합니다. |
| `internal_balance_transfer_outgoing` | 동일한 주체가 소유한 다른 지갑으로의 이체입니다(예: 기본 지갑에서 풀 지갑으로). 수익으로 계산되지 않습니다. |
| `internal_balance_transfer_incoming` | 동일한 주체가 소유한 다른 지갑에서의 이체입니다(예: 상위 지갑에서 풀 지갑으로의 이체). 수익으로 계산되지 않습니다. |

### 통화 환전

| 라인 유형 | 설명 |
| - | - |
| `currency_conversion_outgoing` | 지갑이 통화 간 잔액을 환전할 때 생성되는 원래 통화의 출금입니다. |
| `currency_conversion_incoming` | 지갑이 통화 간 잔액을 환전할 때 생성되는 대상 통화의 입금입니다. |

### 제휴 및 수익 공유

| 라인 유형 | 설명 |
| - | - |
| `payment_referral` | 판매자가 카드 또는 LPM 결제에서 공유하기로 선택한 제휴 추천 보너스로, 제휴자의 지갑에 입금됩니다. |
| `payment_referral_reversal` | 이전에 지급된 추천 보너스를 취소하며, 제휴자의 지갑에서 차감됩니다. |
| `payment_revshare` | 결제 시 판매자의 지갑에서 차감되는 수익 공유 금액입니다. |
| `payment_revshare_payout` | 결제 시 제휴자의 지갑에 입금되는 수익 공유 금액입니다. |
| `payment_revshare_reversal` | 이전에 지급된 수익 공유를 취소하며, 제휴자의 지갑에서 차감됩니다. |
| `payment_revshare_refund` | 환불 또는 분쟁 후 수익 공유 금액을 판매자의 지갑으로 반환합니다. |
| `application_fee_payout` | 하위 계정 결제에서 발생한 플랫폼 수수료로, 상위 계정에 정산됩니다. |
| `platform_affiliate_payment` | 계정 또는 구매자를 Whop에 추천한 데 대한 추천 보너스로, 해당 계정이 발생시킨 처리 수익의 일부입니다. |
| `platform_affiliate_payment_reversal` | Whop이 유효하지 않거나 수정이 필요하다고 판단한 `platform_affiliate_payment`를 취소합니다. |
| `ad_publisher_payout_received` | 퍼블리셔가 얻은 광고 수익을 퍼블리셔의 지갑에 입금합니다. |
| `ad_publisher_payout` | 광고 수익 지급으로, Whop Ads 지갑에서 차감됩니다. |
| `company_referral` | 레거시: 계정을 Whop에 추천한 데 대한 추천 보너스로, 해당 계정이 발생시킨 처리 수익을 공유합니다. |

### 에어드롭

| 라인 유형 | 설명 |
| - | - |
| `airdrop` | Whop의 비용으로 지갑에 입금되는 자금으로, 일반적으로 프로모션 목적이거나 문제를 보상하기 위한 것입니다. |
| `airdrop_reversal` | 유효하지 않거나 수정이 필요한 것으로 확인된 `airdrop`을 취소합니다. |
| `airdrop_link_created` | 새로 생성된 에어드롭 링크에 자금을 제공하기 위해 지갑에서 차감합니다. |
| `airdrop_link_returned` | 발신자가 에어드롭 링크를 취소한 후 링크의 자금을 발신자의 사용 가능 잔액으로 반환합니다. |
| `airdrop_link_redeemed` | 수령된 에어드롭 링크의 자금을 수신자의 사용 가능 잔액에 입금합니다. |
| `resolution_center_refund` | Resolution Center 사례를 구매자에게 유리하게 해결한 후 Whop이 자체 비용으로 부담하는 구매자 환불입니다. |

### 광고

| 라인 유형 | 설명 |
| - | - |
| `ad_campaign_budget` | 캠페인에 자금을 제공할 때 광고 캠페인용 자금을 따로 배정합니다. |
| `ad_spend_charge` | 광고 지출에 대해 배정된 캠페인 자금에서 청구하는 금액으로, 마크업이 적용된 요율로 청구됩니다. |
| `ad_budget_release` | 사용되지 않은 캠페인 예산을 해제하며, 일반적으로 환불 또는 잔액 반환의 첫 단계입니다. |

### 온체인 자산 및 카드

> [!NOTE]
>
> `onchain_deposit`은 옵트인 방식입니다. 기본 피드에서는 제외되며, `line_types`에서 명시적으로 요청할 때만 반환됩니다.

| 라인 유형 | 설명 |
| - | - |
| `onchain_deposit` | Whop 관리 지갑에 입금되는 인바운드 온체인 암호화폐 이체입니다(MoonPay 같은 온램프 포함). 옵트인 방식이며, 명시적으로 요청할 때만 반환됩니다. |
| `onchain_wallet_transfer_outgoing` | Whop 관리 암호화폐 지갑에서 다른 Whop 관리 지갑으로의 아웃바운드 온체인 이체입니다. |
| `onchain_wallet_transfer_incoming` | 다른 Whop 관리 지갑에서 Whop 관리 암호화폐 지갑으로의 인바운드 온체인 이체입니다. |
| `onchain_swap_target` | 온체인 토큰 스왑의 수신 측으로, 지갑에 입금되는 출력 토큰입니다. |
| `treasury_payin` | 암호화폐 잔액을 현금으로 되돌리는 암호화폐 오프램프처럼, 재무 입금(treasury pay-in)으로 현금 지갑에 입금되는 금액입니다. |
| `card_spend_authorization` | 발급사가 구매를 승인할 때 카드 잔액에서 차감되는 카드 승인 보류입니다. |
| `card_spend_authorization_void` | 승인 후 무효화, 만료 또는 거절된 카드 승인을 카드 잔액으로 반환합니다. |
| `card_spend_refund` | 카드 잔액으로 다시 입금되는 판매자 환불입니다. |

### 레거시 및 기타

| 라인 유형 | 설명 |
| - | - |
| `legacy_crypto_payment` | Whop이 처리하여 판매자의 지갑으로 지급한 과거 Coinbase Commerce 결제입니다. |
| `legacy_payment` | 사용자의 지갑에 직접 입금된 과거 익스프레스 계정 결제입니다. |
| `legacy_payment_refund` | `legacy_payment`를 취소하며, 판매자의 지갑에서 차감됩니다. |
| `license_sale` | 다자간 소프트웨어 라이선스 판매에 대한 판매자 지급으로, 수수료를 제외한 판매 금액입니다. 커미션과 수익 공유는 별도의 `license_sale_commission` 및 `license_sale_revenue` 라인 유형을 사용합니다. |
| `license_sale_commission` | 소프트웨어 라이선스 판매의 커미션 부분으로, 커미션 지갑에 입금됩니다. |
| `license_sale_revenue` | 소프트웨어 라이선스 판매의 수익 공유 부분으로, 수익 지갑에 입금됩니다. |
| `software_rental_revshare` | 소프트웨어 대여에 대한 수익 공유 지급으로, 수수료를 제외하고 판매자에게 입금됩니다. |
| `software_rental_transaction` | 소프트웨어 대여의 최종 정산으로, 수수료를 제외하고 판매자에게 입금됩니다. |
| `misc_purchase` | Whop에서 직접 이루어진 구매입니다(예: 레거시 소프트웨어 대여 또는 프록시). |
| `misc_refund` | `misc_purchase`의 환불입니다. |
| `referral_bonus` | 신규 사용자가 whop.com에 가입하도록 추천한 데 대한 보너스입니다. |
| `promo_reversal` | 출금할 수 없는 프로모션 `referral_bonus` 잔액의 일회성 취소입니다. |
| `misc_reversal` | 레거시: 일반적인 거래 수명 주기 외에서 협의된 청구에 대한 기타 출금입니다. |

### 수수료

| 라인 유형 | 설명 |
| - | - |
| `payment_processing_fixed_fee` | 카드 또는 LPM 결제 처리에 대한 고정 수수료(약 \$0.30)입니다. |
| `payment_processing_percentage_fee` | 카드 또는 LPM 결제 처리에 대한 비율 수수료(예: 2.7%)입니다. |
| `billing_percentage_fee` | 구독 관리와 재시도를 포함하는 반복 청구 거래에 대한 수수료입니다. |
| `cross_border_percentage_fee` | 구매자가 처리 지역 외부에 있을 때 부과되는 국가 간 거래 수수료입니다. |
| `fx_percentage_fee` | 외화로 처리된 결제를 정산 시 환전하는 데 대한 수수료입니다. |
| `orchestration_percentage_fee` | 여러 PSP 간 결제 라우팅(스마트 라우팅 및 장애 조치)에 대한 수수료입니다. |
| `revshare_percentage_fee` | 결제에 수익 공유 지급을 사용하는 데 대한 수수료입니다. |
| `three_ds_fixed_fee` | 3DS 인증에 대한 고정 수수료로, 체크아웃에서 3DS가 필요한 경우에만 부과됩니다. |
| `whop_processing_fee` | whop.com 사용에 대한 플랫폼 수수료로, 처리 비용과 직접 연결되지 않습니다. |
| `fraud_prevention_fee` | 카드 또는 LPM 결제의 사기 방지에 대한 수수료입니다. |
| `buyer_fee` | 플랫폼 수입으로 기록되는 구매자 수수료입니다. 구매자 수수료를 플랫폼 수익으로 처리하도록 설정된 경우에만 기록됩니다. |
| `sales_tax_fee` | Whop이 결제에 대한 판매세를 징수하고 납부하는 데 대한 수수료입니다. |
| `sales_tax_remittance` | 거래에서 징수되어 Whop이 세무 당국에 납부하는 판매세입니다. |
| `sales_tax_remittance_reversal` | 결제가 환불되거나 분쟁이 제기된 후 `sales_tax_remittance`를 취소합니다. |
| `affiliate_fee` | 제휴 추천 보너스 지급을 위해 배정된 카드 또는 LPM 결제의 일부입니다. |
| `application_fee` | 하위 계정 결제에서 상위 계정에 지급되는 플랫폼 수수료입니다. |
| `payout_fee` | 은행 계좌로 지급하는 비용을 충당하는 수수료입니다. |
| `payment_dispute_fee` | 카드 또는 LPM 결제에서 지불 거절을 받을 때 부과되는 수수료(약 \$15)입니다. |
| `dispute_alert_fee` | 카드 또는 LPM 결제에서 조기 분쟁 경고를 받을 때 부과되는 수수료입니다. |
| `stripe_domestic_processing_fee` | 레거시: Stripe를 통해 국내에서 카드 또는 LPM 결제를 처리하는 데 대한 수수료입니다. |
| `stripe_international_processing_fee` | 레거시: Stripe를 통해 해외에서 카드 또는 LPM 결제를 처리하는 데 대한 수수료입니다. |


## Related topics

- [List Financial Activity](https://docs.whop.com/ko/api-reference/ledgers/list-financial-activity.md)
- [Financial Activity Funds Available](https://docs.whop.com/ko/api-reference/ledgers/financial-activity-funds-available.md)
- [Get Financial Report](https://docs.whop.com/ko/api-reference/ledgers/get-financial-report.md)
