Get Fee Setting Plan

GET 
/feeSettingPlan/:feeSettingPlanId

Retrieves a Fees & Incentives plan by ID — configures payer fee rules (recoup, surcharge, merchant absorb) per rail, including nested rail settings (cardPaymentFees, networkBankPaymentFees, achBankPaymentFees, amexPaymentFees) with customRate, customFlat, and feeSplitType.

Not merchant processing fees: Plan rates drive payer checkout splits via Split Fees; card-network processing costs appear in List Fees / Fee Events.

Path note: The live API route is /feeSettingPlan/{id} (singular). Integrations OAuth tokens may require merchant dashboard roles; when unavailable, use Split Fees for rate estimates.

There is no list endpoint for fee setting plans in the public API. To obtain rates without already knowing a plan ID, use Split Fees (recommended).

Integrations OAuth note: GET /feeSettingPlan/{id} may return 422 (Body cannot be empty) or 401 with Integrations tokens even when Split Fees succeeds. Treat plan-by-ID read as optional; do not block ERP sync on this route.

Request

Responses

200

Fee setting plan

401

Unauthorized — Integrations OAuth may not include merchant dashboard plan read

404

Not found

422

Validation error — may occur when Integrations token cannot satisfy GET body requirements; use Split Fees instead