Skip to main content

Payment Request Routing Preview

GET 
/api/vendor-deposits/payment-request-routing

Preview where a payment request would route before submitting. Drives the "Payment request will be sent to …" indicator in the Record Proforma Invoice drawer and the draft-deposit hint.

Required scope: accounting:read

Grant this scope to your token under Settings → Developer → Personal Access Tokens.

Routing precedence: matching approval levels → the site-wide default payer (AccountingSettings.vendor_deposit_default_payer_user_id, set in Accounting Settings) → the legacy amount threshold.

Response fields:

  • mode — approval_levels | payer | self_payer | threshold_approval | auto_approve
  • payer — {id, name, email} of the resolved site-wide payer, or null
  • payer_configured — true when a payer id is configured even if unresolvable (admins are notified in that case)
  • levels_count — matching approval levels when mode=approval_levels

auto_approve means nothing is configured: submitting will auto-approve without notifying anyone — the UI warns and links to Accounting Settings.

self_payer means the acting user is themselves the configured payer: there is no one to send a request to, so submitting approves the deposit immediately and the payment can be recorded directly.

Request​

Responses​

OK

Response Headers
    Content-Type