PAYMENT_ALLOCATION_INVALID

Payment allocation not valid: what the PAYMENT_ALLOCATION_INVALID error means and how to fix it.

HTTP 422. Problem type: https://docs.ovok.com/errors/payment-allocation-invalid.

What this means

The payment's split across claims does not hold: the allocations do not add up to amount, one is in another currency, a claim is named twice, or a claim is withdrawn, at another clinic or to another insurer.

Troubleshooting

  1. Check that the allocations amounts add up to amount, all in its currency.
  2. Read each claim (GET /v1/patient-billing/claims/<claimId>) and check that it is active, its clinicId is the payment's, and all share one insurer.
  3. Record a payment that spans several insurers as one payment per insurer.

Retry safely

Nothing was written. The corrected request succeeds once.

If the problem persists

Share the HTTP status, problem type, request path, response timestamp and traceId with your administrator or support contact. Remove access tokens, provider secrets and patient data first. The Error responses guide explains the response fields, and the machine-code registry lists every endpoint-specific type.

Last updated on

On this page