Skip to main content

FPSF-CPD-001 — Reference

Layer: Reference · Audience: developers, implementers For normative requirements, see the Formal Specification.


Glossary

TermDefinition
PaymentA structured act by which a payer causes the transfer of value to a payee, resulting in a change of entitlement recognized by one or more systems of record.
Digital PaymentA Payment in which the expression of intent, authorization, transmission, and confirmation are performed through digital representations and processed by computational systems.
PayerThe participant who initiates the transfer of value.
PayeeThe participant who receives the transferred value.
IntermediaryA participant who facilitates a Payment without being the ultimate sender or receiver of value.
ValueThe economic unit being transferred, defined by an amount and an asset type.
AssetThe denomination of the value being transferred (e.g., a currency code, a tokenized asset identifier).
Payment IdentifierA unique identifier assigned to a Payment at creation. MUST be unique within the relevant system of record.
Intent DescriptorA structure describing the purpose and conditions of a Payment. Optional.
Authorization ProofEvidence that the payer has approved the Payment. MUST be bound to the payer, value, and payee.
Authorization MethodThe mechanism by which the Authorization Proof was produced (e.g., cryptographic signature, institutional mandate).
Execution ContextOptional metadata describing the environment in which a Payment is processed (network, rail, settlement model).
Payment DraftAn incomplete Payment object used as input to the initiation interface. Contains all fields except identifier and state.
System of RecordAny system that authoritatively records the state of a Payment or the change in entitlement resulting from it.

Payment State Reference

StateDescriptionTerminal
CREATEDPayment object instantiated; not yet authorized.No
AUTHORIZEDPayer approval established; ready for submission.No
IN_FLIGHTSubmitted to a processing system; awaiting resolution.No
SETTLEDValue transfer finalized.Yes
FAILEDIrrecoverable failure during processing.Yes
CANCELLEDExplicitly revoked by the payer before settlement.Yes

Permitted State Transitions

FromTo
CREATEDAUTHORIZED
AUTHORIZEDIN_FLIGHT
AUTHORIZEDCANCELLED
IN_FLIGHTSETTLED
IN_FLIGHTFAILED

All other transitions are prohibited.


Interface Summary

InterfaceInputOutputState Transition
initiatePaymentPaymentDraftPaymentCREATED
authorizePaymentpaymentId, AuthorizationProofPaymentCREATEDAUTHORIZED
submitPaymentpaymentId, ExecutionContextPaymentAUTHORIZEDIN_FLIGHT
settlePaymentpaymentIdPaymentIN_FLIGHTSETTLED
getPaymentStatuspaymentIdPaymentState
cancelPaymentpaymentIdPaymentAUTHORIZEDCANCELLED

FPSF-CPD-001 v1.0.0 · Draft · Fabric Payment Standards Foundation · Apache-2.0