---
id: SCR-ACC-BKS-010
title: Payment methods configuration
route: '/console/{tenantId}/configuration/accounting/paymentMethods'
surface: console
product_area: accounting
module: books
revision: 1
status: draft
design_intent: proposed
implementation_evidence: observed
inference: []
source_sha:
  react-console: baf6dae382d6f41dce976c7f848667ccc37e076f
  services-accounting: f47cb263875bbc0c5640fba7dae6785ec32695f8
purpose: >-
  Configure tender methods, reference prompts and the channels in which each
  method is offered.
supports:
  - CAP-ACC-BKS-012
permission: accounting.payment-methods.read
entry_from:
  - >-
    '/console/{tenantId}/configuration' (Accounting group in the configuration
    catalogue)
  - Navigation between Accounting setup screens
exits_to:
  - >-
    '/console/{tenantId}/configuration' (Accounting group in the configuration
    catalogue)
displays:
  - field: 'Methods ordered by sort order and name, showing behavior and availability'
    source: listPaymentMethods
  - field: >-
      Method description, behavior, reference collection, channel and
      public-link availability, offline handling, order and active flag
    source: getPaymentMethod
actions:
  - label: Add Payment Method
    operation_id: createPaymentMethod
    permission: accounting.payment-methods.create
    confirm: false
  - label: Save
    operation_id: updatePaymentMethod
    permission: accounting.payment-methods.update
    confirm: false
  - label: Deactivate or Activate (not system methods)
    operation_id: updatePaymentMethod
    permission: accounting.payment-methods.update
    confirm: false
states:
  - empty
  - loading
  - error
  - read-only
  - inactive
validation:
  - BR-CAP-ACC-BKS-012-01
  - BR-CAP-ACC-BKS-012-02
  - BR-CAP-ACC-BKS-012-03
  - BR-CAP-ACC-BKS-012-04
  - BR-CAP-ACC-BKS-012-05
  - BR-CAP-ACC-BKS-012-06
patterns:
  - 'Shared searchable, sortable configuration list with availability filtering'
  - Shared bulk activation and deactivation without deletion
  - >-
    Side-panel sections for behavior, references, channels, offline payments and
    order
  - Unsaved-changes guard and Accounting loading and error panels
component: components/configuration/resources/payment-methods.tsx
evidence:
  - >-
    react-console at baf6dae3:
    components/configuration/resources/payment-methods.tsx
  - >-
    react-console:components/configuration/config-list-screen.tsx:changeStatus;
    components/configuration/standard.tsx:standardCapabilities (shared-list
    behavior where applicable)
controls: [TC-IAM-001, TC-IAM-002, TC-IAM-004, TC-IAM-005, TC-AZ-001, TC-AZ-002, TC-AZ-003, TC-AZ-004, TC-AZ-005, TC-AZ-006, TC-TEN-001, TC-TEN-002, TC-TEN-003, TC-DAT-004, TC-LOG-001, TC-LOG-002, TC-LOG-003, TC-LOG-004, TC-LOG-005, TC-PI-001, TC-PI-005]
---

# Payment methods configuration

## What the Screen Is For

Configure tender methods, reference prompts and the channels in which each method is offered.

## What It Shows and Lets People Do

Authorized staff can create and replace methods or change availability. The form groups behavior, reference prompts, channel selection, offline handling and order. There is no deletion action. Provisioned methods appear alongside customer-defined ones.

## States and Errors

Behavior is fixed after creation. Offline behaviors expose bounce and deposit handling, while online behavior constrains channel and public-link choices. Provisioned system methods must remain active; the service refuses deactivation. The shared list filters inactive records by default and applies action permissions to controls.

## Patterns It Must Respect

Shared searchable, sortable configuration list with availability filtering. Shared bulk activation and deactivation without deletion. Side-panel sections for behavior, references, channels, offline payments and order. Unsaved-changes guard and Accounting loading and error panels.