orchardcore-payments

CrestApps Orchard Core Payments and Stripe

Payments are provider-neutral. A gateway is an ICheckoutPaymentProvider registered on the tenant; the checkout engine drives it, the durable ledger records it, and every consumer stays unaware of which gateway took the money. Stripe is the shipped card gateway. Installment plans (a Subscriptions sub-feature) build on the same contracts to keep a card and charge it on a schedule.

Related skills: orchardcore-checkout (the engine, steps, test provider), orchardcore-transactions (ledger screens, refunds console), orchardcore-pay-later (offline providers), orchardcore-subscriptions (recurring agreements), orchardcore-taxation.

Features and packages

CrestApps.OrchardCore.Payments.Abstractions is a contracts package (namespace CrestApps.OrchardCore.Payments): Money, CurrencyScale, GatewayMode (Live, Testing), IPaymentEvent, PaymentEventBase, the event contexts and RemoteSubscriptionStatus. Provider contracts are in CrestApps.OrchardCore.Checkout.Abstractions (CrestApps.OrchardCore.Checkout.Services). Install CrestApps.OrchardCore.Stripe in the web/startup project.

{
  "steps": [
    {
      "name": "Feature",
      "enable": [
        "CrestApps.OrchardCore.Checkout",
        "CrestApps.OrchardCore.Stripe"
      ],
      "disable": []
    }
  ]
}

Guidelines

• Amounts are decimal everywhere. Compare with Money.AreEqual and Money.IsGreaterThan, round with Money.Round(amount, currency), and convert to minor units only at the gateway boundary (Money.ToMinorUnits, StripeCurrency). CurrencyScale.GetDecimalPlaces knows JPY (0) and KWD (3).
• Providers are tax-agnostic: they charge the amount the checkout gives them (tax included) and report the net and tax split back in PaymentVerificationResult.
• Never record a payment from a webhook alone. A webhook is a hint; the engine verifies through VerifyAsync against the gateway's API.
• Never refund by calling a gateway. Use ICheckoutRefundService so the refund is recorded first, capped at what remains, taxed from the original snapshot and locked against concurrent refunds.
• Only server code sets savePaymentMethod, offSession, savedCustomerReference and savedPaymentMethodReference.
• Read Stripe options through IOptionsMonitor<StripeOptions>.CurrentValue; they refresh without a tenant restart when settings are saved.
• All C# classes are sealed except view models; recipes use { "steps": [...] }.