How to integrate paystack payment gateway

General
1

How to integrate paystack payment gateway on my app in firebase studio, to launch my app?

2

Hey @Emmanuel_Joe — good question. Integrating Paystack in a Firebase-centered app (especially in environments like Firebase Studio) has some nuance, but it’s totally doable. Here’s a field-tested approach:

1. Choose your integration point (Client vs Server)

  • Client-side (e.g. Flutter / Web / React Native): Use Paystack’s JS SDK or native SDKs, but be careful not to expose your secret key.

  • Server-side (Firebase Cloud Functions / Firebase Hosting backend): This is safer — your secret key stays hidden, and you forward only the minimum data from client to your function.

2. Setup Paystack account & keys

  1. Create a Paystack account (sandbox and production modes).

  2. Obtain public (publishable) key and secret key from your dashboard.

  3. Configure Webhooks (for transaction verification) pointing to a secure endpoint in your backend.

3. Client flow (payment initialization)

  • Client collects payment details (amount, user email, etc.).

  • Client calls your backend function (e.g. initiatePayment) passing minimal info.

  • Backend uses Paystack SDK / REST API to create a transaction, retrieving a reference + payment URL/session.

  • Backend returns the reference or payment URL to client.

  • Client then renders Paystack checkout (redirect or inline iframe) using the public key + reference.

4. Backend verification & webhook

  • After a transaction, Paystack will call your webhook endpoint with transaction status.

  • Your function should validate that the payload is signed (using the transaction signature).

  • Once validated, mark the transaction in your database (Firestore, etc.) as “completed” / “failed” accordingly.

5. Important security & best practices

  • Never embed your secret key on client side.

  • Validate webhooks to prevent spoofing.

  • Use idempotency (check reference before marking done).

  • Rate-limit your backend function to prevent abuse.

  • Log all transaction events for audit.

If you like, I can send you a compact Field Kit PDF just for Paystack integration (with code snippets for Firebase Functions / client) plus a Slack snippet ready to drop — DM me “Paystack Kit” and I’ll deliver it.

3

Paystack kit.

Please, I am actually new person on development. I have finished my prototype on firebase studio.

I have sign up with paystack.

My main challenge is how to integrate payment.

First where do I go?

What do I need to open?

Where exactly do I need to paste the API keys(client and backend keys)?

4

Hello. My account is on hold. Nothing serious I suspect. If you could be patient to allow the Moderator a chance to review many of the replies I have contributed recently, I will be glad to help you move forward if I can. In the meantime I suggest you read the Documentation. A lot of times the answers are in the instructions. It’s where I found mines and how I am now able to help others.

Here’s a helpful tip that should move you along until I get the okay to post new stuff. First take 72 hrs to read the Documentation. Do this after you have moved from draft of the app to this is what we want now in the first Rollout.

Next. Archive your project and start over. Disconnect your billing if you are connected. Start a new project and now use the Documentation to walk through the first steps of app development. This should take you 5 days to complete. Next you should know your pain points. This is more about prioritizing what parts you can effectively and efficiently manage and develop with minimal debugging. If you don’t know how to set up Logs I suggest you make this a priority in reading.

Finally, just for now, I suggest you do not connect billing until you are past A/B Testing. It’s easy to say the App doesn’t work even easier to Spend 72 hrs reading the Start Here do not gloss over this reading and take notes. You should excel from here

5

Try this. After you have created the clean project, here is something that I developed for my future Team. We used Stripe (not a promotion, just worked best for the projects core needs). I have tailored it to fit your needs based on what I think will help move you along.

:open_book: Field Guide – Paystack Integration (Junior Ops Edition)

Tier I – Banner Signal (ASCII Morale Marker)

██████╗  █████╗ ██╗   ██╗███████╗████████╗ █████╗  ██████╗██╗  ██╗
██╔══██╗██╔══██╗██║   ██║██╔════╝╚══██╔══╝██╔══██╗██╔════╝██║ ██╔╝
██║  ██║███████║██║   ██║███████╗   ██║   ███████║██║     █████╔╝ 
██║  ██║██╔══██║██║   ██║╚════██║   ██║   ██╔══██║██║     ██╔═██╗ 
██████╔╝██║  ██║╚██████╔╝███████║   ██║   ██║  ██║╚██████╗██║  ██╗
╚═════╝ ╚═╝  ╚═╝ ╚═════╝ ╚══════╝   ╚═╝   ╚═╝  ╚═╝ ╚═════╝╚═╝  ╚═╝

Signal: Welcome to the field. Integrating payments is your first real deployment. Stay sharp.

Tier II – Step Map

1. Orientation (Where do I go?)

  • Open your Firebase Studio project.

  • Decide if payments should run in your Frontend (Client) or Backend (Server).

  • For safety: NEVER put secret keys in client-side code.

2. Credentials (What do I need to open?)

  • Log into Paystack Dashboard.

  • Get your two key types:

    • Public Key → safe for frontend (used in checkout widget).

    • Secret Key → must stay server-side only.

3. Placement (Where do I paste the keys?)

  • In Firebase Studio, open your .env.local (for local dev) or project Environment Config.

    • Example:

      NEXT_PUBLIC_PAYSTACK_PUBLIC_KEY=pk_test_xxxxx
PAYSTACK_SECRET_KEY=sk_test_xxxxx

  • Frontend: Use NEXT_PUBLIC_PAYSTACK_PUBLIC_KEY when rendering the Paystack button/checkout.

  • Backend (Cloud Function, API Route, or Server SDK): Use PAYSTACK_SECRET_KEY to verify payments.

Tier III – Example Code

Frontend (React / Next.js):

import PaystackPop from '@paystack/inline-js';

const PayButton = () => {
  const pay = () => {
    const paystack = new PaystackPop();
    paystack.newTransaction({
      key: process.env.NEXT_PUBLIC_PAYSTACK_PUBLIC_KEY,
      amount: 2000 * 100, // amount in kobo
      email: "user@example.com",
      onSuccess: (transaction) => {
        console.log("Payment success:", transaction);
      },
      onCancel: () => {
        console.log("Payment cancelled");
      }
    });
  };

  return <button onClick={pay}>Pay Now</button>;
};

Backend (Node.js – Firebase Cloud Function):

import fetch from "node-fetch";

export const verifyPayment = async (reference) => {
  const res = await fetch(`https://api.paystack.co/transaction/verify/${reference}`, {
    headers: { Authorization: `Bearer ${process.env.PAYSTACK_SECRET_KEY}` }
  });
  const data = await res.json();
  return data;
};

Tier IV – Quick Signals

  • :white_check_mark: Public key → frontend (safe).

  • :locked: Secret key → backend only.

  • :satellite_antenna: Always verify payment from backend before granting features.

Tier V – Compact Signal Pulse

>>> PAYSTACK: FRONTEND=PUBLIC, BACKEND=SECRET, VERIFY ALWAYS >>>

If you are unfamiliar with the ‘Signaler’ (ASCII type), you can use it as sort of a Book Marker for your Develoment Pipeline to let you know you locked down this part of your production. Something I learned, you should have a strong git ignore and you should make sure that before you begin integrating payment systems into your project you should make sure that you have fully ran local security checks from within your IDE. Again, I recommend the use of A/B testing of your applications critical features and needs first, and security, protecting users and your organizations most sensitive data should be your first priority.

I should mention: Use NEXT_PUBLIC_PAYSTACK_PUBLIC_KEY when rendering the Paystack button/checkout. that sometimes you may need to create a .css file to hold all your page styling. Depending on what your using for all your dev needs, this may throw Warning Flags that will confuse you when the rest of the code looks correct.

6

Ok. Let me study it. Thank you. I will get back to you.