Normalizer
Every payment provider, one language.
Reconora’s normalizer reads each payment provider’s callbacks, responses and statements in their native format and translates them into one canonical model. On live merchant traffic it reads 96 providers; adding a new one is a configuration, not an integration project.
Eight primitives in every payment message
Every provider transmits the same 8 primitives — only names, places and formats change:
- The merchant’s ID (echoed back)
- The provider’s ID
- The status
- The amount and its role (requested, paid, fee, net)
- The currency
- The event time
- The error
- The message type and channel (create, poll, callback)
One example: as received → as translated
{
"payment": {
"status": "success",
"amount": 15000,
"currency": "CUR-1",
"merchant_ref": "ORD-55120",
"id": "pp_8c1e…a42"
},
"created": "2026-01-15 21:04:11",
"updated": 1768511066,
"trace": "tr-0937",
"session": "s-61f0"
}→event: callback
status: SUCCEEDED
amount: 15000 (minor units)
currency: CUR-1 · precision 2
time: 2026-01-15T21:04:26Z
source: provider "updated", epoch s
ids:
merchant: ORD-55120 (echoed)
provider: pp_8c1e…a42
other: tr-0937, s-61f0A provider callback arrives with the amount in minor units, the status in payment.status, two time fields and four different identifiers. The normalizer recognises the message by its structure, applies the provider’s rule, and emits one event: status SUCCEEDED, amount as an integer with currency and precision, time in UTC with its source, every identifier kept with its origin. A body damaged by the logger’s masking is repaired and flagged.
Why it matters to you
- New providers without a project. A provider is described once by a rule; the engine is shared.
- No silent format drift. When a provider changes its message, a new shape appears and is flagged instead of being read as empty.
- Safe by design. Final statuses are assigned only by approved rules; an unknown value never becomes “paid”.
Providers we read
96 providers from live merchant traffic — names are not disclosed — and more, including the providers listed on our providers page.
Try it on one day of your data
One day of your data, reconciled, and the report stays with you whether or not you continue.
By Reconora Research · Updated