Skip to main content
Chaque ligne comporte un 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

string
requis
ID de l’activité du registre.
account or user
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.
string
requis
Montant signé dans les plus petites unités de précision de la devise.
string | null
requis
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).
object
requis
Devise de cette activité du registre.

Propriétés

string
requis
Code de devise.
string
requis
Facteur de précision de la devise, par exemple 100000000 pour l’USD.
string | null
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.
string
requis
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_target
string
requis
payment | null
Paiement 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

string
requis
ID du paiement, préfixé par pay_.
object | null
requis
Total prélevé par le paiement.

Propriétés

string
requis
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.
string
requis
Code de devise ISO 4217 à trois lettres, en minuscules.
integer
requis
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é.
integer
requis
Nombre de décimales à AFFICHER. Généralement égal à decimals, mais volontairement pas toujours : le COP est prélevé en centavos mais écrit en pesos entiers, il vaut donc 2 et 0. Utilisez cette valeur pour formater le nombre dans votre propre locale.
string | null
requis
Marque de la carte, lorsque le client a payé par carte.
string | null
requis
Quatre derniers chiffres de la carte, lorsque le client a payé par carte.
string
requis
Date de création du paiement.
string
requis
string | null
requis
Mode de paiement utilisé par le client, comme card ou paypal.
string | null
requis
Processeur qui a traité le paiement, comme stripe.
object | null
requis
Variante associée au paiement, le cas échéant.

Propriétés

string
requis
ID de la variante, préfixé par plan_.
string | null
requis
Nom de la variante.
object | null
requis
Produit associé au paiement, le cas échéant.

Propriétés

string
requis
ID du produit, préfixé par prod_.
string
requis
Nom du produit.
object | null
requis
Client associé au paiement. L’e-mail nécessite member:email:read.

Propriétés

string
requis
ID du client, préfixé par user_.
string | null
requis
E-mail du client, ou null sans member:email:read.
string
requis
Nom d’affichage du client.
string | null
ID du paiement pour toute activité liée à un paiement, y compris les remboursements et les litiges.
string | null
ID de la variante associée au paiement, le cas échéant.
string | null
Nom de la variante associée au paiement, le cas échéant.
string
requis
Date de comptabilisation de l’activité dans le registre.
string | null
ID du produit associé au paiement, le cas échéant.
string | null
Nom du produit associé au paiement, le cas échéant.
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.
object | null
requis
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

string
requis
number | null
Montant du versement sous forme de nombre décimal dans la devise de destination (sources payout uniquement ; nécessite payout:withdrawal:read).
string | null
Marque de carte utilisée par la source de paiement.
string | null
Chaîne sur laquelle le dépôt est arrivé, par exemple plasma (sources onchain_transaction uniquement).
string | null
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.
string | null
Date de création du versement sous forme d’horodatage ISO 8601 (sources payout uniquement ; nécessite payout:withdrawal:read).
object | null
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

string
requis
ID de l’utilisateur, préfixé par user_.
string | null
requis
Nom d’affichage.
object
requis
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.

Propriétés

string
requis
URL de l’image de l’avatar. Toujours présente. Il s’agit d’une image de substitution générée lorsque l’utilisateur n’a défini aucune photo.
string
requis
Nom d’utilisateur public.
string | null
Arrivée estimée sous forme d’horodatage ISO 8601 (sources payout uniquement ; nécessite payout:withdrawal:read).
object | null
Total des frais de retrait, frais de majoration compris. Nécessite payout:withdrawal:read.

Propriétés

string
requis
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.
string
requis
Code de devise ISO 4217 à trois lettres, en minuscules.
integer
requis
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é.
integer
requis
Nombre de décimales à AFFICHER. Généralement égal à decimals, mais volontairement pas toujours : le COP est prélevé en centavos mais écrit en pesos entiers, il vaut donc 2 et 0. Utilisez cette valeur pour formater le nombre dans votre propre locale.
string | null
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_spend
string | null
Indique si les frais de retrait sont inclus ou exclus. Nécessite payout:withdrawal:read.Options disponibles : exclusive, inclusive
string | null
Montant converti depuis from_currency sous forme de chaîne décimale (sources swap uniquement).
string | null
Code de devise source de la conversion, en minuscules (sources swap uniquement).
string | null
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).
string
requis
string | null
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.
object | null
Total prélevé par la source de paiement.

Propriétés

string
requis
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.
string
requis
Code de devise ISO 4217 à trois lettres, en minuscules.
integer
requis
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é.
integer
requis
Nombre de décimales à AFFICHER. Généralement égal à decimals, mais volontairement pas toujours : le COP est prélevé en centavos mais écrit en pesos entiers, il vaut donc 2 et 0. Utilisez cette valeur pour formater le nombre dans votre propre locale.
string | null
Moyen de paiement utilisé par la source de paiement. Pour les sources bank_deposit, le réseau de virement : wire, ach ou rtp.
string | null
Processeur utilisé par la source de paiement.
object | null
Montant principal du retrait envoyé à la destination, hors frais, dans la devise du retrait. Nécessite payout:withdrawal:read.

Propriétés

string
requis
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.
string
requis
Code de devise ISO 4217 à trois lettres, en minuscules.
integer
requis
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é.
integer
requis
Nombre de décimales à AFFICHER. Généralement égal à decimals, mais volontairement pas toujours : le COP est prélevé en centavos mais écrit en pesos entiers, il vaut donc 2 et 0. Utilisez cette valeur pour formater le nombre dans votre propre locale.
object | null
Informations d’affichage de la destination du versement (sources payout uniquement).

Propriétés

string | null
string | null
string | null
La réponse de sécurité définie par le marchand lors de l’ajout de ce mode de versement (par exemple un virement Interac), nécessaire pour réclamer le versement. null lorsque la destination n’a pas de réponse personnalisée. Nécessite payout:destination:read.
string | null
Surnom enregistré de la destination du versement (sources payout uniquement).
string | null
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.
boolean | null
Indique si ce versement est actuellement retenu pour un examen manuel des risques (sources payout uniquement ; nécessite payout:withdrawal:read).
string | null
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.
string | null
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).
string | null
Montant reçu en to_currency sous forme de chaîne décimale (sources swap uniquement).
string | null
Code de devise cible de la conversion, en minuscules (sources swap uniquement).
string | null
Référence de traçage bancaire du retrait. Nécessite payout:withdrawal:read.
string | null
Hash de la transaction on-chain (sources onchain_transaction et swap uniquement).
string | null
requis
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.
string | null
E-mail du client associé au paiement. Nécessite member:email:read.
string | null
ID du client associé au paiement.
string | null
Nom d’affichage du client associé au paiement.
LedgerActivity

Glossaire des types de ligne

Chaque ligne d’activité comporte un line_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.

Anciens types et divers

Frais