Worked case · Reference condition · 12 figures

Merchant obligation ledger

Record balanced obligations

Figure 01 / 12

One purchase, several independent states

One purchase, several independent states — Merchant obligation ledger. Fictional batch; times illustrate order, not a rail guarantee. Exact values are in the figure data below.
Fictional batch; times illustrate order, not a rail guarantee

This case concerns record balanced obligations. A success response, a completed capture, and settlement evidence are different observations. The sequence gives each event its own record instead of forcing all of them into one status field.

Figure data and text version
EventTimeRecorded fact
Order accepted09:00Commercial promise exists
Payment instruction09:01A stable payment identifier is assigned
Capture record09:02USD 206,400.00 captured across this batch
Settlement evidenceLaterUSD 200,208.00 observed as settled
Availability decisionAfter reconciliationUSD 166,977.60 available under the stated policy

The ledger records what the platform owes and the assets supporting those obligations. A balanced entry can still encode an incorrect external assumption.

The reference case starts with the stated population and a functioning evidence path. The owner is risk operations.

All amounts, rates, capacity limits, and outcomes in this case are synthetic. The three conditions are separate assumptions for comparison. A better result in the response condition is not measured proof that the proposed control causes that improvement. The figures expose the calculation and its limits; a real deployment needs its own evidence.

Read the result

The batch begins with $215,000 of instructions and $206,400.00 of captured value. At the observation cutoff, $6,192.00 remains pending. After the stated refunds, fees, and restrictions, $166,977.60 is available for payout. The unresolved instruction count is 2; an unknown external result is handled separately from a known decline.

Model inputs and calculated values

Inputs below are the case-specific values. Each figure states the condition-specific assumptions and units used in its calculation. Calculated values are rounded for display.

InputValue
gross215,000
population2,200
feeRate0.021
Calculated valueResult
gross215,000
capture206,400
pending6,192
refund8,256
fee4,334.4
reserve20,640
available166,977.6
cash187,617.6
Figure 02 / 12

From captured value to available payout

From captured value to available payout — Merchant obligation ledger. USD; bridge components. Exact values are in the figure data below.
USD; bridge components

Captured value of $206,400.00 becomes $166,977.60 available after pending settlement, refunds, fees, and eligible restrictions. This is a financial bridge: the bars display each component’s amount, not a cumulative balance. Reserves are restrictions on availability, not an additional fee.

Figure data and text version
ComponentUSD
Captured value206,400
Still pending-6,192
Refunds-8,256
Fees-4,334.4
Restricted cover-20,640
Available payout166,977.6
Figure 03 / 12

Balanced postings are necessary but not sufficient

Balanced postings are necessary but not sufficient — Merchant obligation ledger. Simplified ledger; fees paid from merchant proceeds; one currency. Exact values are in the figure data below.
Simplified ledger; fees paid from merchant proceeds; one currency

The first entry records a settlement receivable and a merchant obligation for $206,400.00. Later entries move the observed settled amount to cash and record fees and refunds. Debits equal credits within each posting; external evidence is still required to establish that settlement occurred.

Figure data and text version
EntryDebit accountCredit accountUSD
CaptureSettlement receivableMerchant payable206,400
SettleBank cashSettlement receivable200,208
RefundMerchant payableBank cash8,256
Fee paidMerchant payableBank cash4,334.4
Figure 04 / 12

Recorded value and usable value differ

Recorded value and usable value differ — Merchant obligation ledger. USD; overlapping measures, not additive categories. Exact values are in the figure data below.
USD; overlapping measures, not additive categories

Gross instructions total $215,000, but only $206,400.00 has been captured. Pending value cannot be counted as settled cash in this illustration. The final availability decision also includes the stated restriction. These amounts are different views of one batch, so do not add the bars together.

Figure data and text version
ViewUSD
Instructed215,000
Captured206,400
Settled200,208
Cash after refunds and fees187,617.6
Available for payout166,977.6
Figure 05 / 12

Timing of receipts and uses

Timing of receipts and uses — Merchant obligation ledger. Cumulative USD. Exact values are in the figure data below.
Cumulative USD

The synthetic ladder stages both receipts and uses over five days. Its purpose is to make timing explicit. The fractions are illustrative scheduling assumptions, not observed payment-rail behavior. A positive total over the full period does not prove that funds are available at every earlier cutoff. Horizontal positions are the labeled observations or scenarios; equal spacing does not imply equal numerical increments.

Figure data and text version
PeriodCumulative receiptsCumulative uses
Day 020,020.817,956.8
Day 180,083.271,827.2
Day 2140,145.6125,697.6
Day 3180,187.2161,611.2
Day 4200,208179,568
Figure 06 / 12

A reconciliation identity with explicit components

A reconciliation identity with explicit components — Merchant obligation ledger. USD; all values use the same batch cutoff. Exact values are in the figure data below.
USD; all values use the same batch cutoff

The identity is capture = pending + refunds + fees + restricted cover + available payout, provided cash after fees and refunds is nonnegative. Here both sides equal $206,400.00. The identity locates differences; it cannot validate an incorrect input source.

Figure data and text version
ComponentUSDEvidence
Captured206,400Batch records
Pending settlement6,192Batch records
Settled200,208Batch records
Refunds8,256Journal and availability policy
Fees4,334.4Journal and availability policy
Restricted cover20,640Journal and availability policy
Available payout166,977.6Journal and availability policy
Figure 07 / 12

One business action can produce several messages

One business action can produce several messages — Merchant obligation ledger. Message delivery versus business effect. Exact values are in the figure data below.
Message delivery versus business effect

The batch contains 2,200 intended actions and 1 duplicate attempts in this teaching trace. A stable action key identifies the business instruction. A transport identifier identifies one delivery attempt. Treating both identifiers as interchangeable is the route to duplicate financial effects.

Figure data and text version
StepContract
Receive2200 intended actions; 1 repeated deliveries
MatchLook up the business action key and request fingerprint
CommitCreate one journal effect within the approved transaction boundary
ReplyReturn the stored result or a controlled conflict
Figure 08 / 12

Unknown outcomes need their own queue

Unknown outcomes need their own queue — Merchant obligation ledger. Count; exclusive instruction states. Exact values are in the figure data below.
Count; exclusive instruction states

2 of the 2200 instructions have an unknown external outcome at the cutoff. They are not automatically failed. The remaining counts are constructed disjoint states for this example and sum to the total number of intended actions.

Figure data and text version
StateCount
Known complete2,022
Known declined176
Unknown external outcome2
Figure 09 / 12

A money record carries units and identity

A money record carries units and identity — Merchant obligation ledger. Illustrative machine record. Exact values are in the figure data below.
Illustrative machine record

An integer amount is meaningful only with its currency and exponent convention. A provider identifier is meaningful only with its namespace. The data contract keeps the action identity, financial amount, and external observation separate so they can be reconciled.

Figure data and text version
FieldExamplePurpose
batch_refMerchant obligation ledgerStable cohort identity
currencyUSDNo mixed-currency addition
gross_minor21,500,000Two decimal places in this USD example
availability_minor16,697,760Derived usable amount
settlement_statepartialFinancial evidence state
Figure 10 / 12

Pending settlement changes available cash

Pending settlement changes available cash — Merchant obligation ledger. USD; all other inputs held fixed. Exact values are in the figure data below.
USD; all other inputs held fixed

This sensitivity calculation holds capture, refunds, fees, and reserve fixed, then varies the pending share. Available payout is floored at zero. The curve describes the stated formula, not a recommended payout hold or a forecast of return timing. Horizontal positions are the labeled observations or scenarios; equal spacing does not imply equal numerical increments.

Figure data and text version
Pending shareAvailable USD
0%173,169.6
5%162,849.6
10%152,529.6
20%131,889.6
30%111,249.6
40%90,609.6
Figure 11 / 12

Economic claims after the event

Economic claims after the event — Merchant obligation ledger. Illustrative responsibility map. Exact values are in the figure data below.
Illustrative responsibility map

The edges label obligations or evidence relationships. They do not assert that the named firm performs every legal role in every payment arrangement. The purpose is to keep the commercial promise, settlement evidence, and payout obligation visible at the same time.

Figure data and text version
FromToRelationship
Merchant obligation ledgerMerchantFulfillment promise
ProcessorPlatform ledgerSettlement evidence
Platform ledgerMerchantPayout obligation
Platform ledgerReview queue2 unresolved
Figure 12 / 12

The close record preserves unresolved differences

The close record preserves unresolved differences — Merchant obligation ledger. Close-of-window record. Exact values are in the figure data below.
Close-of-window record

Available payout is $166,977.60; restricted cover is $20,640.00. The illustration also keeps 2 unresolved outcomes and $0.00 of any reserve shortfall visible. A close process should not hide unresolved items merely to force a report to balance.

Figure data and text version
MeasureValueOwner
Available payoutUSD 166,977.60Treasury
Restricted coverUSD 20,640.00Merchant risk
Unresolved instructions2Payment operations
Reserve shortfallUSD 0.00Exposure owner

Connect the result to the system

Use a receivable state and reconcile the bank and processor records.

Check the population, evidence, permitted action, and actual effect together. A balanced calculation can still use the wrong population; a successful response can still leave an unknown financial outcome. The case’s numerical result applies only to its stated assumptions.

Sources and further reading

The chapter sources support the concepts and scope. They do not prescribe the synthetic model rates.

  1. Stripe: idempotent requests (provider example)
  2. Stripe: PaymentIntent lifecycle (provider example)