whatisgithub

What is subscriptionbridge?

arkfile/subscriptionbridge — explained in plain English

Analysis updated 2026-05-18

0Audience · developerComplexity · 4/5Setup · hard

In one sentence

A backend bridge that connects your app to Stripe or Adyen for subscriptions while keeping your users' identities and the payment processor's data separate.

Mindmap

mindmap
  root((Subscription Bridge))
    What it does
      Bridges app and payment processor
      Keeps identities separate
      Normalizes subscription state
    Tech stack
      PostgreSQL
      Stripe adapter
      Adyen adapter
    Use cases
      Add subscriptions privately
      Reconcile subscription state
      Handle recurring Adyen billing
    Audience
      Backend developers
    Status
      Greenfield project
      No production deployments yet

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Add Stripe or Adyen subscriptions to an app without exposing user identities to the processor.

USE CASE 2

Keep payment processor credentials and identifiers off your own app's servers.

USE CASE 3

Reconcile subscription state between your app and a payment processor using signed callbacks.

USE CASE 4

Support recurring Adyen billing with automatic retries and payment method replacement.

What is it built with?

PostgreSQLStripe APIAdyen APIHMAC-SHA256HKDF-SHA256

How does it compare?

arkfile/subscriptionbridge00kaku/gallery-slider-block04amanrajj/netwatch
Stars00
LanguageJavaScriptRust
Last pushed2021-05-19
MaintenanceDormant
Setup difficultyhardeasymoderate
Complexity4/52/53/5
Audiencedevelopergeneralops devops

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · hard Time to first run · 1day+

Requires integrating both a Stripe and an Adyen conforming adapter, plus PostgreSQL and a shared cryptographic pairing root.

No license information is stated in the README.

So what is it?

Subscription Bridge is a backend service that sits between an app you already run and the payment processors that handle recurring subscriptions, currently Stripe and Adyen. Its whole purpose is to let your app offer subscriptions without ever having to hand your users' identities over to the payment processor, and without your app needing to know which processor is actually being used behind the scenes. The way it splits responsibility is deliberate. Your app keeps usernames, your own plan catalog, and whatever feature limits you attach to each plan. Subscription Bridge instead keeps the processor's own account identifiers, payment method references, and the state of each recurring payment. The two sides only share a small set of meaningless reference codes, like a checkout id and a subscription reference, so that even someone with access to the bridge's database cannot directly see who a real customer is. The project is upfront that if someone had access to both your app's database and the bridge's database, they could still connect the dots, since the design reduces exposure rather than making that connection impossible. Underneath, every message between your app and the bridge is signed using cryptographic keys derived from a single secret, so that a request or a callback claiming to come from one side or the other can be verified as genuine. The project maintains a formal specification document as the source of truth for exact message formats and behavior, and it ships fixture test data that other implementations of the same protocol are expected to match exactly. On the payment processor side, Stripe manages the subscription schedule directly through its own checkout and billing tools, while for Adyen the bridge itself owns the renewal schedule and handles retrying failed charges, replacing expired payment methods, and canceling subscriptions. The project describes itself as a greenfield effort still under active development, with no live production deployments yet and no promise that things will not change. It is intentionally narrow: it does not attempt to handle one-off payments, taxes, coupons, currency conversion, or multiple client apps sharing one deployment.

Copy-paste prompts

Prompt 1
Explain how Subscription Bridge keeps consumer identities separate from Stripe and Adyen.
Prompt 2
Walk me through how the checkout_id and subscription_ref values connect my app to the bridge.
Prompt 3
Show me how the HMAC signed callback system works between the bridge and a consumer app.
Prompt 4
Help me understand the difference in how Stripe versus Adyen subscriptions are handled here.

Frequently asked questions

What is subscriptionbridge?

A backend bridge that connects your app to Stripe or Adyen for subscriptions while keeping your users' identities and the payment processor's data separate.

What license does subscriptionbridge use?

No license information is stated in the README.

How hard is subscriptionbridge to set up?

Setup difficulty is rated hard, with roughly 1day+ to a first successful run.

Who is subscriptionbridge for?

Mainly developer.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.