Bulk manually reconcile records

post

https://api.staging.payrails.io/reconciliation/records/reconcile

Marks multiple reconciliation records as manually reconciled in a single bulk operation, capturing operator supplied reasons and comments. Records must not already be in a reconciled resolution. The response includes a summary of successes and failures.

Body Params

Payload used to bulk manually reconcile multiple records. Both tagSlugs and reasons are optional — manual reconciliation can run without any tags. When both are supplied, tagSlugs is the source of truth and reasons is ignored. The same tag set applies to every record in the batch.

array of uuids

required

length ≥ 1

List of record identifiers to reconcile.

id*

tagSlugs

array of strings

Slugs of merchant-catalog tags to attach to every record in the batch as part of the reconcile action. Validated against the merchant tag catalog once before any DB write.

tagSlugs

reasons

array of strings

deprecated

Deprecated. Use tagSlugs instead. Existing values continue to work and are coerced into the tag slug list when tagSlugs is empty; they will also be persisted on the published manual-reconciliation-action analytics event so downstream dashboards keep working. This field may be removed in a future major release.

reasons

comments

string | null

Optional operator comments associated with the manual reconciliation.

Responses

Language

Credentials

Bearer

JWT

Loading…

Response

Choose an example:

application/json

200Bulk reconciliation completed. See response for individual record outcomes.

400Bad Request.

401Unauthorized.

403Forbidden.

429Too Many Requests.

500Internal Server Error.