Pin Payments MCP by usefulapi

The current Pin Payments account balance: available (ready to transfer) and pending (available plus estimated funds from charges that have not settled yet), per currency, in the currency's base unit (cents for AUD). GET /balance.

Takes no parameters.

List charges (card payments), 25 per page: amount (in the currency's base unit, e.g. cents for AUD), currency, description, payer email, status_message/success, total_fees, merchant_entitlement, amount_refunded, captured, settlement transfers, chargebacks flag, metadata. The card is shown only as scheme and last four digits. GET /charges.

Search charges by free text (description, email, metadata, cardholder name, currency, exact amount in the currency's base unit, exact charge/card/refund/customer token) and/or a created-date range. GET /charges/search.

One charge by token (ch_...), with fees, refunds total, settlement transfer state and chargeback flag. GET /charges/{token}.

All refunds issued against one charge. GET /charges/{token}/refunds.

List all refunds, 25 per page: amount (in the currency's base unit), currency, charge token, status_message, error_message, created_at. GET /refunds.

One refund by token (rf_...). GET /refunds/{token}.

List card authorisations (held funds, not yet captured; they expire after seven days) with amount, amount_captured, amount_remaining and expired flags. GET /authorisations.

One authorisation by token (auth_...). GET /authorisations/{token}.

List stored customers, 25 per page: token, email, first_name, last_name, phone_number, company, notes and the primary card as scheme and last four digits. GET /customers.

One customer by token (cus_...). GET /customers/{token}.

Charges made by one customer. GET /customers/{token}/charges.

Cards stored for one customer, each shown only as scheme, last four digits and issuing country (no token, expiry or address). GET /customers/{token}/cards.

Subscriptions of one customer: state, plan, next billing date, active interval, cancellation time. GET /customers/{token}/subscriptions.

List deposits made to the account (amount, currency, bank narration, available_at). GET /deposits.

One deposit by token (dpo_...). GET /deposits/{token}.

List transfers (payouts to bank accounts), 25 per page: status, amount, debits/credits, paid_at, reference, line item count, bank account (masked) and recipient. GET /transfers.

Search transfers by token, description, amount or recipient details and/or a created-date range. GET /transfers/search.

One transfer by token (tfer_...). GET /transfers/{token}.

The ledger line items that make up one transfer (charge entitlements, fees, refunds, chargebacks). GET /transfers/{token}/line_items.

List transfer recipients (name, email, masked bank account). GET /recipients.

One recipient by token (rp_...). GET /recipients/{token}.

Transfers paid to one recipient. GET /recipients/{token}/transfers.

List chargeback disputes: category, status, amount, the disputed charge, evidence_required_by and the relevant evidence types. GET /disputes.

Search disputes by status or exact charge token, optionally filtered by status. GET /disputes/search.

One dispute by token (dis_...). GET /disputes/{token}.

The activity feed of one dispute (status changes, ledger entries such as chargeback fees and recoveries). GET /disputes/{token}/activity.

List subscription plans: name, amount, currency, interval, trial and setup amounts, subscription counts by state. GET /plans.

One plan by token (plan_...). GET /plans/{token}.

Subscriptions to one plan. GET /plans/{token}/subscriptions.

List all subscriptions: state (trial, active, cancelling, cancelled), plan, customer, next_billing_date, active interval, cancelled_at. GET /subscriptions.

One subscription by token (sub_...). GET /subscriptions/{token}.

The ledger entries (credits and debits) of one subscription. GET /subscriptions/{token}/ledger.

The account's event log (charge.captured, refund.created, dispute.updated, ...), each with the affected record (cards masked). GET /events.

One event by token (evt_...). GET /events/{token}.