What the public API does not support today
This page lists capabilities partners often expect but are not part of the current public Paystand X API contract on Netlify. These are product or future API items — not omissions you can work around with different query parameters alone.
Bulk export and filtering
| Capability | Status | What to use instead |
|---|---|---|
| Merchant bulk list of receivable transactions (payment/refund applications across all invoices) | Not available | Per-receivable List Receivable Transactions, or Receivable Transaction Events webhooks |
view=export on fees or receivable transactions | Not documented / not partner-ready | List Fees (merchant processing fees), fee webhooks, nested receivable transaction routes |
Date-range (by-query-filters) on fees | Not supported | Fee Events (merchant processing fees) or paginate GET /fees and filter client-side by payment ID |
Date-range (by-query-filters) on credit memos | Not supported | List Credit Memos with f.querytype=own, by-payerCustomerId, or by-erpName |
| Sub-day time windows (e.g. 10:00–11:00) | Not supported | Calendar-day f.datestart / f.dateend only; see Query and incremental sync |
Delete and void semantics
| Capability | Status | What to use instead |
|---|---|---|
| Hard DELETE receivables or payer customers | Not supported for partners | Cancel Receivable; update receivable status to cancelled |
| DELETE payer customer | No public DELETE route | Create and update payer customers only |
Auth and roles
| Capability | Status | What to use instead |
|---|---|---|
| Facilitator or platform tokens required for ERP sync | Not required | Merchant API credentials: Access Token, Bearer header, X-CUSTOMER-ID |
| List Fees / Get Fee with Integrations OAuth | May return 401 | Get Payment embedded fees[] (merchant processing fees) / feeSplit (payer-side split), or Fee Events. Not a wrong merchant ID — same token works for payments and Split Fees; Integrations OAuth is scoped without GET /fees list/read in the platform resource registry. |
| Compute Fee with Integrations OAuth | May return 401 | Split Fees or Compute Fees (fee split) for payer estimates; embedded fees[] on Get Payment after capture |
| Get Fee Setting Plan by ID with Integrations OAuth | May return 422 or 401 | Split Fees — no public list endpoint for plan IDs |
| Get Dispute by ID when merchant has no disputes | List returns count: 0; invalid IDs may return 401 (not 404) | Poll List Disputes; use dispute webhooks when disputes exist |
| Get Merchant Timezone with Integrations OAuth | May return 400 on some merchants | Pass f.timezone explicitly (IANA name from merchant settings), or skip — see Get Merchant Timezone |
Fee plans and payment amounts
Merchant processing fees (List Fees, Fee Events) and payer fees (Split Fees, feeSplit) use different endpoints — see Payment and fee reconciliation.
| Capability | Status | What to use instead |
|---|---|---|
| List all fee setting plans | No list endpoint | Split Fees or Compute Fees (fee split) — GET /feeSettingPlan/{id} is unreliable with Integrations OAuth |
| Guaranteed payment principal vs fee split on every GET | Field parity varies | Payment and fee reconciliation, fee webhooks, Split Fees for pre-payment estimates |
Webhooks
| Capability | Status | What to use instead |
|---|---|---|
| Withdrawal webhooks | No dedicated public webhook page | Poll withdrawals and transfers; use Transfer Events for payout status |
| Transfer / withdrawal line items on List or Get Transfer | Aggregate payout only on those routes | Use List Transfer Report Entries after the transfer report is completed — see Bank reconciliation |