rail read card · MerchantCardSale

← back to Rails

MerchantCardSale two-leg

EditIn Use

Identity

Name
MerchantCardSale
Description

One merchant card-sale posting. Card network force-posts the external (debit) leg via daily settlement file; SNB records the matching credit on the MerchantPayableClearing GL. The transfer_key of (merchant_id, settlement_period) joins this firing into the shared MerchantSettlementCycle Transfer — many sales for one (merchant, period) share one Transfer.id. Note: NO expected_net on this rail because it's a leg of the MerchantSettlementCycle template (S2: template legs MUST NOT carry expected_net).

Topology

Source role
ExternalCardNetwork
Destination role
MerchantPayableClearing

Origin

Origin
—
Source origin (override)
ExternalForcePosted
Destination origin (override)
InternalInitiated

Conservation

Expected net (standalone firing)
—

Activity / cadence

Aggregating
false
Cadence
—
Bundles activity
—

Metadata

Metadata keys
merchant_idsettlement_periodcard_network_refcard_brand
Metadata value examples
card_brand: - Visa - Mastercard - Amex

Posted requirements

Posted requirements
merchant_id, settlement_period, card_network_ref

Aging

Max pending age
P1D
Max unbundled age
P2D

Soft bounds

Typical amount range (min, max)
5.00, 500.00
Typical firings per period (min, max)
—