List scored customer payment candidates for a bank transaction
accounting:readReturns a 5-band scored list of order_payments candidates that could be
matched to an inbound bank deposit. Only applies to inbound transactions
(direction='in' or NULL). Returns already_matched: true if the transaction
is already matched.
Scoring bands:
- 1.0 — Exact amount + same calendar day
- 0.9 — Exact amount + within 2 days
- 0.8 — Within $0.01 + same day
- 0.7 — Within $0.05 + within 2 days + customer name in description
- 0.6 — Within $0.05 fallback (remaining candidates)
A.2 Multi-invoice payments: Payments where order_id IS NULL but
have one or more rows in order_payment_applications are flagged with
is_multi_application: true and application_count.
No GL postings occur on match. GL was posted when the payment receipt was recorded. This endpoint is read-only scoring only.
Authorizations
API key issued per entity via Settings > Developers > API Keys.
Each key carries scopes (e.g. orders:read, products:write).
Bearer token format: Authorization: Bearer ark_live_ent_Test keys use ark_test_ent_. Both are issued per entity
via Settings > Developers > API Keys.
Path Parameters
UUID of the inbound bank transaction to score candidates for
Response
Candidate list (may be empty)

