Skip to main content
각 행에는 유형이 지정된 resource와 source가 포함되어 있어 추가 조회 없이 이벤트를 표시하고 연결할 수 있습니다. Financial Activity API를 사용하여 계정 또는 사용자의 명세서나 거래 피드를 만들고, 재무 보고서로 특정 기간의 잔액 활동, 수입, 잔액을 요약한 다음, 보고서 합계를 그 원인별로 세분화할 수 있습니다.

엔드포인트

속성

string
필수
원장 활동 ID입니다.
account or user
이 행의 원장을 소유한 조회자 계정입니다. 응답이 소유 계정을 집계하는 경우(include_owned_accounts=true)에만 포함되며, 그 외에는 생략됩니다.
string
필수
통화의 최소 정밀도 단위로 표시된 부호 있는 금액입니다.
string | null
필수
이 활동이 사용 가능 자금에 영향을 주는 시점의 ISO 8601 타임스탬프입니다. 대기 중인 확정 자금(good-funds) 해제 버킷의 입금 및 출금은 예정된 해제일의 00:00:00 UTC이며, 환불, 분쟁, 지급을 포함하여 정산된 사용 가능 자금에 대한 입금 및 출금은 기록 시각입니다. 온체인 행을 포함하여 이 경로 밖의 활동은 Null입니다. available_after/before 필터는 이 값의 UTC 날짜를 사용하며, 기본 활동에서는 옵트인 적립금을 포함한 일부 이동이 제외됩니다.
object
필수
이 원장 활동의 통화입니다.

속성

string
필수
통화 코드입니다.
string
필수
통화의 정밀도 계수입니다(예: USD의 경우 100000000).
string | null
이 행이 속한 원장 계정(ldgr_ 식별자)입니다. 응답이 소유 계정을 집계하는 경우(include_owned_accounts=true)에만 포함되며, 그 외에는 생략됩니다. account와 함께 사용하여 드로어와 대시보드 링크의 범위를 소유 비즈니스로 지정하세요.
string
필수
이 활동이 기록된 원장 라인 카테고리입니다.사용 가능한 옵션: 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
string
필수
payment | null
이 원장 활동과 관련된 결제입니다. 리치 리소스 하이드레이션이 활성화되어 있고 이동이 결제와 연결된 경우 포함됩니다.

속성

string
필수
결제 ID이며, pay_ 접두사로 시작합니다.
object | null
필수
결제로 청구된 총액입니다.

속성

string
필수
주 단위 금액이며, 정확한 십진수 문자열입니다. 예를 들어 "10.00"은 10달러입니다. 전송 중 부동소수점 반올림이 발생하지 않도록 문자열로 제공됩니다.
string
필수
소문자로 된 세 글자 ISO 4217 통화 코드입니다.
integer
필수
금액이 갖는 소수 자릿수입니다. 실제 결제가 처리되는 정밀도입니다.
integer
필수
표시할 소수 자릿수입니다. 일반적으로 decimals와 같지만, 의도적으로 항상 같지는 않습니다. COP는 센타보 단위로 청구되지만 페소 단위로 표기되므로 각각 2와 0입니다. 이 값을 사용하여 사용자의 로캘에 맞게 숫자를 포맷하세요.
string | null
필수
고객이 카드로 결제한 경우의 카드 브랜드입니다.
string | null
필수
고객이 카드로 결제한 경우의 카드 마지막 네 자리입니다.
string
필수
결제가 생성된 시각입니다.
string
필수
string | null
필수
고객의 결제 방법입니다(예: card 또는 paypal).
string | null
필수
결제를 처리한 프로세서입니다(예: stripe).
object | null
필수
해당되는 경우, 결제와 연결된 변형입니다.

속성

string
필수
변형 ID이며, plan_ 접두사로 시작합니다.
string | null
필수
변형 이름입니다.
object | null
필수
해당되는 경우, 결제와 연결된 상품입니다.

속성

string
필수
상품 ID이며, prod_ 접두사로 시작합니다.
string
필수
상품 이름입니다.
object | null
필수
결제와 연결된 고객입니다. 이메일은 member:email:read 권한이 필요합니다.

속성

string
필수
고객 ID이며, user_ 접두사로 시작합니다.
string | null
필수
고객 이메일이며, member:email:read 권한이 없으면 null입니다.
string
필수
고객 표시 이름입니다.
string | null
환불 및 분쟁을 포함한 모든 결제 관련 활동의 결제 ID입니다.
string | null
해당되는 경우, 결제와 연결된 변형의 ID입니다.
string | null
해당되는 경우, 결제와 연결된 변형의 이름입니다.
string
필수
활동이 원장에 기록된 시각입니다.
string | null
해당되는 경우, 결제와 연결된 상품의 ID입니다.
string | null
해당되는 경우, 결제와 연결된 상품의 이름입니다.
account or user or bounty or ledger_account or payment_method or payout_method or card_transaction | null
필수
이 원장 활동과 연결된 리소스입니다.
object | null
필수
이 원장 활동의 출처입니다. 플랫폼 마크업 수수료는 platform_fee 객체와 원장 활동 ID를 사용합니다.

속성

string
필수
number | null
대상 통화로 표시된 십진수 지급 금액입니다(payout 출처에만 해당, payout:withdrawal:read 필요).
string | null
결제 출처에서 사용된 카드 브랜드입니다.
string | null
입금이 도착한 체인입니다(예: plasma, onchain_transaction 출처에만 해당).
string | null
에어드롭의 수령 URL입니다. 호출자가 자금 제공 계정의 수령 링크를 관리하거나 자금 제공 개인 잔액에서 출금할 수 있는 경우가 아니면 Null입니다.
string | null
지급 생성 시각이며, ISO 8601 타임스탬프입니다(payout 출처에만 해당, payout:withdrawal:read 필요).
object | null
출금을 요청한 사용자입니다. 시스템에서 생성된 출금이거나 payout:withdrawal:read 권한이 없으면 Null입니다.

속성

string
필수
사용자 ID이며, user_ 접두사로 시작합니다.
string | null
필수
표시 이름입니다.
object
필수
아바타 래퍼입니다. url은 항상 존재하며, 사용자가 사진을 설정하지 않은 경우 생성된 플레이스홀더입니다.

속성

string
필수
아바타 이미지 URL입니다. 항상 존재합니다. 사용자가 사진을 설정하지 않은 경우 생성된 플레이스홀더입니다.
string
필수
공개 사용자 이름입니다.
string | null
예상 도착 시각이며, ISO 8601 타임스탬프입니다(payout 출처에만 해당, payout:withdrawal:read 필요).
object | null
마크업 수수료를 포함한 총 출금 수수료입니다. payout:withdrawal:read가 필요합니다.

속성

string
필수
주 단위 금액이며, 정확한 십진수 문자열입니다. 예를 들어 "10.00"은 10달러입니다. 전송 중 부동소수점 반올림이 발생하지 않도록 문자열로 제공됩니다.
string
필수
소문자로 된 세 글자 ISO 4217 통화 코드입니다.
integer
필수
금액이 갖는 소수 자릿수입니다. 실제 결제가 처리되는 정밀도입니다.
integer
필수
표시할 소수 자릿수입니다. 일반적으로 decimals와 같지만, 의도적으로 항상 같지는 않습니다. COP는 센타보 단위로 청구되지만 페소 단위로 표기되므로 각각 2와 0입니다. 이 값을 사용하여 사용자의 로캘에 맞게 숫자를 포맷하세요.
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
string | null
출금 수수료가 포함 방식인지 별도 방식인지 여부입니다. payout:withdrawal:read가 필요합니다.사용 가능한 옵션: exclusive, inclusive
string | null
from_currency에서 전환된 금액이며, 십진수 문자열입니다(swap 출처에만 해당).
string | null
전환 전 통화의 소문자 통화 코드입니다(swap 출처에만 해당).
string | null
transfer, payout 또는 bank_deposit 출처에 첨부된 메모이며, 제공되지 않은 경우 null입니다(payout 출처에서는 payout:withdrawal:read 필요).
string
필수
string | null
payout 출처에서는 지급을 처리하는 기관의 이름입니다(payout:withdrawal:read 필요). bank_deposit 출처에서는 입금을 보낸 계좌의 이름입니다.
object | null
결제 출처에서 청구된 총액입니다.

속성

string
필수
주 단위 금액이며, 정확한 십진수 문자열입니다. 예를 들어 "10.00"은 10달러입니다. 전송 중 부동소수점 반올림이 발생하지 않도록 문자열로 제공됩니다.
string
필수
소문자로 된 세 글자 ISO 4217 통화 코드입니다.
integer
필수
금액이 갖는 소수 자릿수입니다. 실제 결제가 처리되는 정밀도입니다.
integer
필수
표시할 소수 자릿수입니다. 일반적으로 decimals와 같지만, 의도적으로 항상 같지는 않습니다. COP는 센타보 단위로 청구되지만 페소 단위로 표기되므로 각각 2와 0입니다. 이 값을 사용하여 사용자의 로캘에 맞게 숫자를 포맷하세요.
string | null
결제 출처에서 사용된 결제 수단입니다. bank_deposit 출처에서는 이체 방식인 wire, ach 또는 rtp입니다.
string | null
결제 출처에서 사용된 프로세서입니다.
object | null
수수료를 제외하고 대상에 전송된 출금 원금이며, 출금 통화 기준입니다. payout:withdrawal:read가 필요합니다.

속성

string
필수
주 단위 금액이며, 정확한 십진수 문자열입니다. 예를 들어 "10.00"은 10달러입니다. 전송 중 부동소수점 반올림이 발생하지 않도록 문자열로 제공됩니다.
string
필수
소문자로 된 세 글자 ISO 4217 통화 코드입니다.
integer
필수
금액이 갖는 소수 자릿수입니다. 실제 결제가 처리되는 정밀도입니다.
integer
필수
표시할 소수 자릿수입니다. 일반적으로 decimals와 같지만, 의도적으로 항상 같지는 않습니다. COP는 센타보 단위로 청구되지만 페소 단위로 표기되므로 각각 2와 0입니다. 이 값을 사용하여 사용자의 로캘에 맞게 숫자를 포맷하세요.
object | null
지급 대상 표시 정보입니다(payout 출처에만 해당).

속성

string | null
string | null
string | null
판매자가 이 지급 수단(예: Interac e-Transfer)을 추가할 때 설정한 보안 답변으로, 지급을 수령하는 데 필요합니다. 대상에 사용자 지정 답변이 없으면 null입니다. payout:destination:read가 필요합니다.
string | null
저장된 지급 대상의 별칭입니다(payout 출처에만 해당).
string | null
활동이 발생한 이유입니다. transfer 출처에서는 이체 사유입니다(예: pool_top_up 또는 bounty_return). payout 출처에서는 지급이 취소, 거부 또는 실패한 이유를 설명하며(payout:withdrawal:read 필요), 지급이 정상적으로 진행 중인 동안에는 null입니다.
boolean | null
이 지급이 현재 수동 위험 검토를 위해 보류 중인지 여부입니다(payout 출처에만 해당, payout:withdrawal:read 필요).
string | null
onchain_transaction 출처에서는 발신 지갑 주소 또는 온램프 제공업체 식별자입니다. bank_deposit 출처에서는 송금 은행 계좌의 마지막 네 자리입니다(예: ••••1547).
string | null
수명 주기 상태입니다. payout 출처에서는 지급 상태이며(payout:withdrawal:read 필요), airdrop_link 출처에서는 수령 링크 상태이고(제한 없음), payment 및 top-up 출처에서는 succeeded/pending/failed 같은 사용자 친화적 결제 상태이며(제한 없음), bank_deposit 출처에서는 succeeded, reversal_in_progress 또는 reversed입니다(제한 없음).
string | null
to_currency로 받은 금액이며, 십진수 문자열입니다(swap 출처에만 해당).
string | null
전환 후 통화의 소문자 통화 코드입니다(swap 출처에만 해당).
string | null
출금에 대한 은행 추적 참조 번호입니다. payout:withdrawal:read가 필요합니다.
string | null
온체인 트랜잭션 해시입니다(onchain_transaction 및 swap 출처에만 해당).
string | null
필수
이 이동의 달러 가치이며, amount와 같은 부호를 갖는 십진수 문자열입니다. 라인이 기록될 당시의 환율로 기록 금액을 환산한 값으로, 지갑 잔액 차트와 재무 보고서가 사용하는 것과 동일한 가격 기준이므로 암호화폐 행에도 달러 가치가 포함됩니다. Whop이 환율을 보유하지 않은 통화의 경우 null입니다.
string | null
결제와 연결된 고객의 이메일입니다. member:email:read가 필요합니다.
string | null
결제와 연결된 고객의 ID입니다.
string | 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에서 명시적으로 요청할 때만 반환됩니다.

레거시 및 기타

수수료