PinStripe - A Stripe "Small Development Kit" for Elixir

eileennoonan

PinStripe is a “small development kit” for Elixir and Stripe based off of @wojtekmach’s article SDKs with Req: Stripe on the Dashbit blog.

That blog post is great for more senior programmers and people who have time to roll their own integration. But what about those who just want to say “boom, Stripe”?

It would be great if Stripe provided an official Elixir SDK, but they don’t. The community project Stripity Stripe attempts to fill that gap. It has worked great for many people for a long time, but since the Stripe API is so sprawling it’s been cumbersome for maintainers and new code hasn’t been merged in over a year. This can give newcomers pause.

PinStripe aspires to find a middle ground by providing a maintainable, minimalistic interface with a few conveniences that should cover 95% of use cases without needing to meticulously cover the entire Stripe SDK.

Features include:

Simple API Client built on Req with automatic ID prefix recognition
Webhook Handler DSL using Spark for clean, declarative webhook handling
Automatic Signature Verification for webhook security
Code Generators powered by Igniter for zero-config setup
Sync with Stripe to keep your local handlers in sync with your Stripe dashboard

Please note this library is still experimental! Tests are passing, igniter installation and mix tasks all seem to work! But community feedback and contributions are very welcome.

Kudos to @lawik for help with the name!

28 comments

#library #stripe #pin-stripe

35 2681 28

2026-02-12 03:35:31 UTC

Showing Posts 1 to 10

Show Best Posts
Show All (oldest first)
Show All (newest first)

lawik

Nerves Core Team

ThinStripe, PinStripe, RacingStripe, TigerCantChangeIts. So many naming options

Post #1

olivermt

EarnedMyStripes

Post #2

eileennoonan

Oh I really love PinStripe!

Gonna wait to see if more suggestions roll in before I pull the trigger on that but that’s great. Fun, fashionable, rolls of the tongue, and yet also suggests professionalism.

Post #3

lawik

Nerves Core Team

And also organized crime

Post #4

eileennoonan

It is pretty gangster

Post #5

eileennoonan

TinyElixirStripe has officially been renamed to PinStripe!

Kudos to @lawik for the Don Draper energy!

@AstonJ - is it possible to update the title of this post?

Post #6

kevinschweikert

Done

Post #7

eileennoonan

Thank you! Is it also possible to edit the tags? I’d like a pin-stripe tag I can subscribe to

Post #8

eileennoonan

PinStripe v0.2.2: Testing Utilities

PinStripe now includes handy testing utilities. This release adds two new modules.

PinStripe.Test.Mock provides high-level mocking helpers that wrap Req.Test:

test "reads a customer using stub_read" do
  Mock.stub_read("cus_123", %{"id" => "cus_123", "email" => "test@example.com"})

  {:ok, response} = Client.read("cus_123")
  assert response.body["email"] == "test@example.com"
end

PinStripe.Test.Fixtures leans on Stripe CLI to provide fixture generation:

test "creates a customer" do
  # Load/generate a customer fixture (use atoms for API resources)
  customer = PinStripe.Test.Fixtures.load(:customer)

  # Use with Req.Test
  Req.Test.stub(PinStripe, fn conn ->
    Req.Test.json(conn, customer)
  end)

  {:ok, response} = Client.create(:customers, %{email: "test@example.com"})
  assert response.body["object"] == "customer"
end

Fixture generation requires a Stripe test API Key (live keys are not allowed). Each unique generated fixture will create a record in your Stripe dev dashboard and a cached version in test/fixtures/stripe.

If/when you change your Stripe API version, you can run mix pin_stripe.sync_api_version to fetch the current version and clear all locally cached fixtures. Fixtures will then be regenerated the next time you run your tests.

Post #9