Skip to main content

Resolve Merchant Route

POST 

/v1/merchant

Resolve a raw bank-transaction string to a catalogue service.

Always returns a 200 with a stable :class:MerchantResponse shape; misses set matched=false / confidence=0 / every nullable field null so SDK consumers branch on a single key rather than on presence.

Raises :class:MerchantFeatureNotAvailable for tiers without the merchant_resolution entitlement (handler maps to 403 feature_not_available). Raises :class:fastapi.HTTPException (429) when the daily bucket is exhausted.

Request

Responses

Successful Response