schema-aggregator

ServiceSettlement Schema

Container: Settlement.settlementAttributes Protocol Version: 2.0 Semantic Model: generalised Use Cases: Payment confirmation, settlement tracking, receipt management Tags: generic-service, on-demand, professional-services

Overview

ServiceSettlement records payment settlement details for a confirmed service contract, tracking whether the provider has received payment, when it was recorded, and the receipt reference.

Attachment points

• Primary: Contract.settlements[].settlementAttributes in on_status messages

Design rationale

ServiceSettlement is separate from the pricing terms (ServiceConsideration) because settlement happens at a different time in the transaction lifecycle. Consideration is agreed at confirmation time, but settlement is updated in status messages as payments are processed.

Non-goals

This schema does NOT define:

• Pricing or payment methods (belongs in ServiceConsideration)
• Bank or payment processor details (implementation-specific)
• Refund processing (domain-specific)

Upstream candidates

Related upstream schemas in Beckn Core:

• Settlement (generic Beckn settlement)