Taking payments
Connect Stripe to your app
What is Stripe?
Stripe is a payments company. It lets your app take card payments online.
- What it costs
- Creating an account and test keys is free. Stripe takes a fee from each real payment. Stripe is not open to everyone: in India and Indonesia it is invite-only, and in Nigeria and Kenya it points you to Paystack.
- Time needed
- About 10 minutes for test keys. Real (live) payments need Stripe to check your business first.
- If you skip it
- Your app still works. Only taking payments stays off until you connect it.
What you can build with Stripe
How to get it, step by step
Get your keys
- Sign up or sign in at stripe.com.
- To test first, open a sandbox: press Sandboxes in the account menu at the top, then open or create one.
- Open the API keys page: dashboard.stripe.com/apikeys.
- Copy the Publishable key, then the secret key next to it.
- When you are ready for real payments, switch from sandbox to live mode on the same page. Press Reveal live key to see the live secret key.
Set up payment notices (webhook)
- Open dashboard.stripe.com/webhooks and press Create an event destination, then choose Your account.
- Choose the events BooDoo asked for, press Continue, choose Webhook endpoint, press Continue.
- For Endpoint URL, ask BooDoo in the chat for your app’s payment-notice address and paste it.
- On the new webhook’s page, press Reveal secret and copy it.
Which value goes in which box
- Publishable key
STRIPE_PUBLISHABLE_KEYNot secret - The Publishable key. It starts with pk_test_ or pk_live_ and is not secret.
- Secret key
STRIPE_SECRET_KEYKeep private - The Secret key. It starts with sk_test_ or sk_live_. This one is secret.
- Webhook signing secret
STRIPE_WEBHOOK_SECRETKeep private - The signing secret you revealed. It starts with whsec_.
Watch out for
- Test keys and live keys are separate. Going live means saving new keys and a new webhook secret.
- A live secret key you create yourself is shown only once. Copy it before closing the window.
- Keep it private, like a password. Only the publishable key (pk_) is safe to show.