resource와 source가 포함되어 있어 추가 조회 없이 이벤트를 표시하고 연결할 수 있습니다.
Financial Activity API를 사용하여 계정 또는 사용자의 명세서나 거래 피드를 만들고, 재무 보고서로 특정 기간의 잔액 활동, 수입, 잔액을 요약한 다음, 보고서 합계를 그 원인별로 세분화할 수 있습니다.
엔드포인트
속성
이 행의 원장을 소유한 조회자 계정입니다. 응답이 소유 계정을 집계하는 경우(include_owned_accounts=true)에만 포함되며, 그 외에는 생략됩니다.
이 활동이 사용 가능 자금에 영향을 주는 시점의 ISO 8601 타임스탬프입니다. 대기 중인 확정 자금(good-funds) 해제 버킷의 입금 및 출금은 예정된 해제일의 00:00:00 UTC이며, 환불, 분쟁, 지급을 포함하여 정산된 사용 가능 자금에 대한 입금 및 출금은 기록 시각입니다. 온체인 행을 포함하여 이 경로 밖의 활동은 Null입니다. available_after/before 필터는 이 값의 UTC 날짜를 사용하며, 기본 활동에서는 옵트인 적립금을 포함한 일부 이동이 제외됩니다.
이 행이 속한 원장 계정(ldgr_ 식별자)입니다. 응답이 소유 계정을 집계하는 경우(include_owned_accounts=true)에만 포함되며, 그 외에는 생략됩니다.
account와 함께 사용하여 드로어와 대시보드 링크의 범위를 소유 비즈니스로 지정하세요.이 활동이 기록된 원장 라인 카테고리입니다.사용 가능한 옵션:
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이 원장 활동과 관련된 결제입니다. 리치 리소스 하이드레이션이 활성화되어 있고 이동이 결제와 연결된 경우 포함됩니다.
속성
속성
결제로 청구된 총액입니다.
속성
속성
account or user or bounty or ledger_account or payment_method or payout_method or card_transaction | null
필수
이 원장 활동과 연결된 리소스입니다.
이 원장 활동의 출처입니다. 플랫폼 마크업 수수료는 platform_fee 객체와 원장 활동 ID를 사용합니다.
속성
속성
마크업 수수료를 포함한 총 출금 수수료입니다. payout:withdrawal:read가 필요합니다.
속성
속성
플랫폼 마크업 수수료를 발생시킨 작업입니다: deposit, swap, transfer, card_spend 또는 payout. include_resource가 false인 경우를 포함하여 platform_markup_fee 및 platform_markup_fee_payout에 포함됩니다. 원래 작업을 확인할 수 없으면 Null이며, 다른 출처 유형에서는 생략됩니다.사용 가능한 옵션:
payout, transfer, deposit, swap, card_spend출금 수수료가 포함 방식인지 별도 방식인지 여부입니다. payout:withdrawal:read가 필요합니다.사용 가능한 옵션:
exclusive, inclusivetransfer, payout 또는 bank_deposit 출처에 첨부된 메모이며, 제공되지 않은 경우 null입니다(payout 출처에서는 payout:withdrawal:read 필요).
payout 출처에서는 지급을 처리하는 기관의 이름입니다(payout:withdrawal:read 필요). bank_deposit 출처에서는 입금을 보낸 계좌의 이름입니다.
결제 출처에서 청구된 총액입니다.
속성
속성
수수료를 제외하고 대상에 전송된 출금 원금이며, 출금 통화 기준입니다. payout:withdrawal:read가 필요합니다.
속성
속성
활동이 발생한 이유입니다. transfer 출처에서는 이체 사유입니다(예: pool_top_up 또는 bounty_return). payout 출처에서는 지급이 취소, 거부 또는 실패한 이유를 설명하며(payout:withdrawal:read 필요), 지급이 정상적으로 진행 중인 동안에는 null입니다.
onchain_transaction 출처에서는 발신 지갑 주소 또는 온램프 제공업체 식별자입니다. bank_deposit 출처에서는 송금 은행 계좌의 마지막 네 자리입니다(예:
••••1547).수명 주기 상태입니다. payout 출처에서는 지급 상태이며(payout:withdrawal:read 필요), airdrop_link 출처에서는 수령 링크 상태이고(제한 없음), payment 및 top-up 출처에서는 succeeded/pending/failed 같은 사용자 친화적 결제 상태이며(제한 없음), bank_deposit 출처에서는 succeeded, reversal_in_progress 또는 reversed입니다(제한 없음).
이 이동의 달러 가치이며,
amount와 같은 부호를 갖는 십진수 문자열입니다. 라인이 기록될 당시의 환율로 기록 금액을 환산한 값으로, 지갑 잔액 차트와 재무 보고서가 사용하는 것과 동일한 가격 기준이므로 암호화폐 행에도 달러 가치가 포함됩니다. Whop이 환율을 보유하지 않은 통화의 경우 null입니다.LedgerActivity
라인 유형 용어집
모든 활동 행에는 해당 행이 나타내는 금융 이벤트를 지정하는line_type이 있습니다. Financial Activity 목록 조회에 하나 이상의 line_types를 전달하여 특정 이벤트로 피드를 필터링할 수 있으며, 반복되는 line_types[] 파라미터 또는 쉼표로 구분된 단일 값(line_types=payment_gross,payment_refund)으로 전달합니다. 알 수 없는 라인 유형은 400을 반환합니다.
LPM(Local Payment Method)은 은행 자동이체, 은행 송금, 지갑을 포함한 카드 이외의 결제 수단을 의미합니다.
카테고리
개별 라인 유형을 나열하는 대신 카테고리 약칭을 전달할 수 있습니다. 카테고리는 포함된 모든 라인 유형으로 확장됩니다.결제
환불
분쟁
적립금
지급
이체
통화 환전
제휴 및 수익 공유
에어드롭
광고
온체인 자산 및 카드
onchain_deposit은 옵트인 방식입니다. 기본 피드에서는 제외되며, line_types에서 명시적으로 요청할 때만 반환됩니다.
