effect-payments

Disclaimer: This is an experiment, mostly created with Claude Code. Don’t use this in production.

A vendor-neutral payments core for Effect, with Stripe, PayPal and Airwallex providers. Write a program against the core's capabilities; choose the provider by the layer you provide.

Package	Purpose
@thomasfosterau/effect-payments	The core: capability services, neutral entities, Money, Page, IdempotencyKey, Stub and the PaymentsError channel. Peer: effect.
@thomasfosterau/effect-payments-stripe	Every capability over Distilled's Stripe operations (@distilled.cloud/stripe), plus the raw Stripe resource modules (thin wrappers of every Distilled operation on each resource) and the WebCrypto webhook verifier. Peer: effect ^4.0.0 (Distilled's own range); optional peer: stripe.
@thomasfosterau/effect-payments-paypal	Products, Prices, PaymentIntents, Subscriptions, Refunds over Distilled's PayPal operations (@distilled.cloud/paypal), with the package's own OAuth login. Peer: effect ^4.0.0 (Distilled's own range).
@thomasfosterau/effect-payments-airwallex	Customers, PaymentIntents, Refunds over Airwallex.

Install

Install the core, the provider you use, and effect (a peer: your application owns the single copy):

pnpm add effect @thomasfosterau/effect-payments @thomasfosterau/effect-payments-stripe

Example

import { Effect, Layer, Redacted } from "effect";
import { FetchHttpClient } from "effect/http";
import * as Customer from "@thomasfosterau/effect-payments/Customer";
import * as StripePayments from "@thomasfosterau/effect-payments-stripe/StripePayments";

const program = Customer.create({ email: "jane@example.com" }); // needs only `Customers`

const layer = StripePayments.layer({ apiKey: Redacted.make("sk_test_...") }).pipe(
  Layer.provide(FetchHttpClient.layer),
);

// Calls Stripe when invoked: `const customer = await createCustomer();`
const createCustomer = () => Effect.runPromise(program.pipe(Effect.provide(layer)));

Each package's README is its API reference. Runnable examples are in packages/payments-stripe/examples.

Development

See CONTRIBUTING.md; conventions for agents are in AGENTS.md. Releases go through Changesets (PUBLISHING.md); report vulnerabilities as SECURITY.md describes.

License

MIT © Thomas Foster