resource et une source typés afin que vous puissiez présenter l’événement et créer un lien vers celui-ci sans requêtes supplémentaires.
Utilisez l’API Activité financière pour créer un relevé ou un flux de transactions pour un compte ou un utilisateur, et les rapports financiers pour résumer l’activité du solde, les revenus et les soldes sur une période donnée, puis décomposer le total d’un rapport selon ses composantes.
Endpoints
Attributs
Le compte de l’utilisateur consultant qui possède le registre de cette ligne. Présent uniquement lorsque la réponse agrège les comptes détenus (include_owned_accounts=true) ; omis sinon.
Horodatage ISO 8601 du moment où cette activité affecte les fonds disponibles : 00:00:00 UTC à la date de libération prévue pour les crédits et débits se trouvant dans un compartiment de libération de fonds en attente ; l’heure de comptabilisation pour les crédits et débits sur des fonds disponibles réglés, y compris les remboursements, litiges et versements. Null pour les activités hors de ces cas, y compris les lignes on-chain. Les filtres available_after/before utilisent sa date UTC ; l’activité par défaut exclut certains mouvements, notamment les réserves facultatives (opt-in).
Le compte de registre (un identifiant ldgr_) auquel appartient cette ligne. Présent uniquement lorsque la réponse agrège les comptes détenus (include_owned_accounts=true) ; omis sinon. Associez-le à
account pour limiter les panneaux et les liens du tableau de bord à l’entreprise propriétaire.La catégorie de ligne du registre sous laquelle cette activité a été comptabilisée.Options disponibles :
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_targetPaiement lié à cette activité du registre. Inclus lorsque l’hydratation enrichie des ressources est activée et que le mouvement est lié à un paiement.
Propriétés
Propriétés
Total prélevé par le paiement.
Propriétés
Propriétés
Le montant en unités principales, sous forme de chaîne décimale exacte. Par exemple,
"10.00" correspond à dix dollars. Il s’agit d’une chaîne afin qu’aucun nombre à virgule flottante ne l’arrondisse en transit.Nombre de décimales que comporte le montant. Il s’agit de la précision avec laquelle le prélèvement lui-même est effectué.
ID du paiement pour toute activité liée à un paiement, y compris les remboursements et les litiges.
account or user or bounty or ledger_account or payment_method or payout_method or card_transaction | null
requis
Ressource associée à cette activité du registre.
Source de cette activité du registre. Les frais de majoration de la plateforme utilisent l’objet platform_fee et l’ID de l’activité du registre.
Propriétés
Propriétés
Montant du versement sous forme de nombre décimal dans la devise de destination (sources payout uniquement ; nécessite payout:withdrawal:read).
Chaîne sur laquelle le dépôt est arrivé, par exemple plasma (sources onchain_transaction uniquement).
L’URL de réclamation de l’airdrop. Null sauf si l’appelant peut gérer les liens de réclamation sur le compte de financement ou effectuer des retraits depuis le solde personnel de financement.
Date de création du versement sous forme d’horodatage ISO 8601 (sources payout uniquement ; nécessite payout:withdrawal:read).
Utilisateur ayant demandé le retrait. Null pour les retraits générés par le système ou sans payout:withdrawal:read.
Propriétés
Propriétés
Conteneur de l’avatar. Son
url est toujours présente, et correspond à une image de substitution générée lorsque l’utilisateur n’a défini aucune photo.Arrivée estimée sous forme d’horodatage ISO 8601 (sources payout uniquement ; nécessite payout:withdrawal:read).
Total des frais de retrait, frais de majoration compris. Nécessite payout:withdrawal:read.
Propriétés
Propriétés
Le montant en unités principales, sous forme de chaîne décimale exacte. Par exemple,
"10.00" correspond à dix dollars. Il s’agit d’une chaîne afin qu’aucun nombre à virgule flottante ne l’arrondisse en transit.Nombre de décimales que comporte le montant. Il s’agit de la précision avec laquelle le prélèvement lui-même est effectué.
Action ayant généré des frais de majoration de la plateforme : deposit, swap, transfer, card_spend ou payout. Présent pour platform_markup_fee et platform_markup_fee_payout, y compris lorsque include_resource vaut false. Null lorsque l’action d’origine n’est pas disponible ; omis pour les autres types de source.Options disponibles :
payout, transfer, deposit, swap, card_spendIndique si les frais de retrait sont inclus ou exclus. Nécessite payout:withdrawal:read.Options disponibles :
exclusive, inclusiveMontant converti depuis from_currency sous forme de chaîne décimale (sources swap uniquement).
Mémo joint à la source transfer, payout ou bank_deposit, ou null si aucun n’a été fourni (pour les sources payout, nécessite payout:withdrawal:read).
Pour les sources payout, le nom de l’entité qui traite le versement (nécessite payout:withdrawal:read). Pour les sources bank_deposit, le nom du compte ayant envoyé le dépôt.
Total prélevé par la source de paiement.
Propriétés
Propriétés
Le montant en unités principales, sous forme de chaîne décimale exacte. Par exemple,
"10.00" correspond à dix dollars. Il s’agit d’une chaîne afin qu’aucun nombre à virgule flottante ne l’arrondisse en transit.Nombre de décimales que comporte le montant. Il s’agit de la précision avec laquelle le prélèvement lui-même est effectué.
Moyen de paiement utilisé par la source de paiement. Pour les sources bank_deposit, le réseau de virement :
wire, ach ou rtp.Montant principal du retrait envoyé à la destination, hors frais, dans la devise du retrait. Nécessite payout:withdrawal:read.
Propriétés
Propriétés
Le montant en unités principales, sous forme de chaîne décimale exacte. Par exemple,
"10.00" correspond à dix dollars. Il s’agit d’une chaîne afin qu’aucun nombre à virgule flottante ne l’arrondisse en transit.Nombre de décimales que comporte le montant. Il s’agit de la précision avec laquelle le prélèvement lui-même est effectué.
Informations d’affichage de la destination du versement (sources payout uniquement).
Propriétés
Propriétés
Raison de l’activité. Pour les sources transfer, il s’agit du motif du transfert, par exemple pool_top_up ou bounty_return. Pour les sources payout, il explique pourquoi le versement a été annulé, refusé ou a échoué (nécessite payout:withdrawal:read) ; null tant que le versement se déroule normalement.
Indique si ce versement est actuellement retenu pour un examen manuel des risques (sources payout uniquement ; nécessite payout:withdrawal:read).
Pour les sources onchain_transaction, l’adresse du portefeuille expéditeur ou l’identifiant du fournisseur d’onramp. Pour les sources bank_deposit, les quatre derniers chiffres du compte bancaire expéditeur, comme
••••1547.Statut du cycle de vie. Pour les sources payout, il s’agit du statut du versement (nécessite payout:withdrawal:read) ; pour les sources airdrop_link, du statut du lien de réclamation (sans restriction) ; pour les sources de paiement et de rechargement, du statut lisible du paiement, comme succeeded/pending/failed (sans restriction) ; pour les sources bank_deposit, il vaut succeeded, reversal_in_progress ou reversed (sans restriction).
Valeur en dollars de ce mouvement sous forme de chaîne décimale, signée comme
amount. Convertie à partir du montant comptabilisé au taux en vigueur au moment de la comptabilisation de la ligne — la même tarification que celle utilisée par le graphique du solde du portefeuille et les rapports financiers — de sorte qu’une ligne crypto comporte aussi sa valeur en dollars. null pour une devise pour laquelle Whop ne dispose d’aucun taux de change.LedgerActivity
Glossaire des types de ligne
Chaque ligne d’activité comporte unline_type qui désigne l’événement financier qu’elle représente. Transmettez un ou plusieurs line_types à Lister l’activité financière pour filtrer le flux sur des événements précis — soit sous forme de paramètres line_types[] répétés, soit sous forme d’une seule valeur séparée par des virgules (line_types=payment_gross,payment_refund). Les types de ligne inconnus renvoient une erreur 400.
Le terme moyen de paiement local (Local Payment Method, LPM) désigne un moyen autre que la carte, notamment les prélèvements bancaires, les virements bancaires et les portefeuilles électroniques.
Catégories
Au lieu de lister des types de ligne individuels, vous pouvez transmettre un raccourci de catégorie. Une catégorie se développe en tous les types de ligne qu’elle contient.Paiements
Remboursements
Litiges
Réserves
Versements
Transferts
Conversion de devises
Affiliés et partage de revenus
Airdrops
Publicité
Actifs on-chain et cartes
onchain_deposit est facultatif (opt-in) : il est exclu du flux par défaut et n’est renvoyé que si vous le demandez explicitement dans line_types.
