gemmeinDocs
gemmein.comDashboard
dashboard

Payments

Payments holds your app's connection to Stripe, the plans a person can be on, and the products they can buy. Choose how each one is sold, what credits it grants, and what a buyer receives.

Steps

Connect Stripe

  1. Open Payments to see your Stripe connection, your plans and your products, for the environment you're in.

    Open Payments to see your Stripe connection, your plans and your products, for the environment you're in.

  2. Open Stripe connection and create a restricted key in Stripe with only the permissions listed: five, plus two if you sell plans. When Stripe asks how you'll use the key, choose “Powering an integration you built”, then “Choose your own”.

    Open Stripe connection and create a restricted key in Stripe with only the permissions listed: five, plus two if you sell plans. When Stripe asks how you'll use the key, choose “Powering an integration you built”, then “Choose your own”.

  3. Choose Add key, paste the key and choose Connect Stripe. Gemmein checks the permissions your app needs and registers the webhook in Stripe itself.

    Choose Add key, paste the key and choose Connect Stripe. Gemmein checks the permissions your app needs and registers the webhook in Stripe itself.

  4. Choose Check now to ask Stripe about the key and the webhook again. Once connected, the card shows the key, the 11 events Stripe sends to Gemmein, and that payments are on.

    Choose Check now to ask Stripe about the key and the webhook again. Once connected, the card shows the key, the 11 events Stripe sends to Gemmein, and that payments are on.

  5. Choose Replace key to swap in a new key from the same Stripe account. The same steps open, and the webhook and your Payment Links stay as they are.

    Choose Replace key to swap in a new key from the same Stripe account. The same steps open, and the webhook and your Payment Links stay as they are.

Plans

  1. Open Plans to see the plans a person can be on and how each one is sold.

    Open Plans to see the plans a person can be on and how each one is sold.

Add a plan

  1. Choose Add a plan and name it. It takes four questions and changes nothing else in your payments setup.

    Choose Add a plan and name it. It takes four questions and changes nothing else in your payments setup.

  2. Choose Stripe and set the price. Gemmein makes the plan's price and Payment Link in Stripe, so there is no link to paste.

    Choose Stripe and set the price. Gemmein makes the plan's price and Payment Link in Stripe, so there is no link to paste.

  3. Set the credits it grants each period, and what happens to unused credits when the next period is paid.

    Set the credits it grants each period, and what happens to unused credits when the next period is paid.

  4. Review shows what a person pays, what they get, and what happens if they cancel, before the plan is created.

    Review shows what a person pays, what they get, and what happens if they cancel, before the plan is created.

  5. Choose Add it to your plans. Gemmein makes the Payment Link in Stripe and the plan appears in your list, marked on sale.

    Choose Add it to your plans. Gemmein makes the Payment Link in Stripe and the plan appears in your list, marked on sale.

Change a plan

  1. Open a plan you already have to change how it's sold: through Stripe, by a relay, or not sold yet.

    Open a plan you already have to change how it's sold: through Stripe, by a relay, or not sold yet.

  2. Set Credits each period to grant credits with every paid period, and choose what happens to credits left unused.

    Set Credits each period to grant credits with every paid period, and choose what happens to credits left unused.

  3. Choose Save plan to save this plan. Each plan saves on its own, and leaving it unsaved keeps what it was.

    Choose Save plan to save this plan. Each plan saves on its own, and leaving it unsaved keeps what it was.

Products

  1. Open Products to see the one-off things people can buy, like a pack of credits.

    Open Products to see the one-off things people can buy, like a pack of credits.

  2. Choose Add a product, then Stripe, and set its price. Gemmein makes its price and Payment Link in Stripe.

    Choose Add a product, then Stripe, and set its price. Gemmein makes its price and Payment Link in Stripe.

  3. Review shows the price, where receipts go, what the buyer keeps, and the code your app uses to show what they bought.

    Review shows the price, where receipts go, what the buyer keeps, and the code your app uses to show what they bought.

  4. Open a product you already sell to change how it's sold and what the buyer receives: a file, a link, or credits.

    Open a product you already sell to change how it's sold and what the buyer receives: a file, a link, or credits.

Turn payments off or disconnect

  1. Choose the Payments switch to turn payments off. Nothing can be bought here, and Gemmein turns off the Payment Links it made in Stripe.

    Choose the Payments switch to turn payments off. Nothing can be bought here, and Gemmein turns off the Payment Links it made in Stripe.

  2. Choose Disconnect Stripe to stop Gemmein creating or changing things in Stripe. Your Payment Links and webhook keep working, and payments keep arriving.

    Choose Disconnect Stripe to stop Gemmein creating or changing things in Stripe. Your Payment Links and webhook keep working, and payments keep arriving.

Errors

  • connect Stripe first

    Selling through Stripe needs the Stripe connection: Gemmein makes each price and its Payment Link with your restricted key.

  • That's a live-mode key. Development takes a test-mode key (rk_test_…). Use it in Live.

    Development connects Stripe's test mode, and Live connects its live mode.

  • This key can do far more than Gemmein needs.

    Gemmein refuses a key that can do more than the permissions listed: five, plus two if you sell plans. Set every other permission to None.

  • a number, such as 15 or 15.00

    A price is an amount in the currency you choose.

  • the price must be more than zero

    A plan's price is what Stripe charges each period, so it is more than zero.

  • a whole number of credits each period, or empty

    A plan grants a whole number of credits, in full, each paid period.

How plans, products and payment links work: Payments.

Was this page helpful?

Last updated