Skip to main content

List PayPal Transactions

GET 

/api/paypal/integrations/:id/transactions

Lists PayPal account activity imported for one PayPal integration: payments, refunds, chargebacks, bank transfers, holds and fees, each classified against the payments SKU.io has recorded.

Authentication: Requires Bearer token.

match_status values: matched (linked to a payment SKU.io recorded, or a refund of one), recovered (a pay-link payment whose notification was missed; the import recorded the payment), unmatched (a completed payment no SKU.io pay link references), pending (e.g. an eCheck still clearing), denied, disputed (chargeback), not_applicable (transfers, holds, currency conversions).

type values: payment, refund, chargeback, transfer, fee, hold, currency_conversion, other (derived from PayPal's T-code in event_code).

Amounts: signed as PayPal reports them; fee_amount is negative for fees charged, net_amount = gross + fee.

Advanced filters: pass a base64-encoded filter_groups tree with {column}.{operator} conditions on transaction_id, event_code, payer_email, payer_name (text operators), gross_amount, fee_amount, net_amount (numeric operators) and transaction_date (datetime operators).

Sorts: transaction_date, gross_amount, fee_amount, net_amount, id (prefix with - for descending; default -transaction_date).

Pagination: page, per_page (default 15).

Not yet available to API tokens

This endpoint currently requires session authentication; Personal Access Token scope support is in progress.

Request​

Responses​

OK

Response Headers
    Content-Type