Facebook iconWebhook integration with Stripe Payment Intents
Blogs/Technology

WebHook integration with Stripe Payment Intents

Nov 4, 20243 Min Read
Written by Murtuza Kutub
WebHook integration with Stripe Payment Intents Hero

You may have heard about Webhooks when integrating payment providers Stripe, Razorpay, Dwolla, etc in your application. I was working on one of the rails applications and had to integrate Stripe payment in that. So I read about webhook, what it does and integrated with my application.

In this blog, I am going to cover the following things:

  1. What is a webhook?
  2. Webhook integration with Stripe payment intent.

What is a WebHook?

A WebHook is an HTTP callback: an HTTP POST that occurs when something happens. With all APIs, there’s a request followed by a response. Even for webhook, the request is made by the payment provider. just the difference is here request is initiated by another server instead of a client-side browser.

WebHook integration with Stripe Payment Intent

To use a webhook, you’ll have to register a URL with the Payment Gateway. This URL is a place within your application that will accept the data and process it. Whenever any change to your payment application happens eg: a customer creating a transfer, adding a new bank account, withdrawing funds, etc., the Payment provider will notify your application server using this webhook endpoint present in your server. It is generally a good practice to record all requests sent to this endpoint by the payment provider and process only the topics that are of application’s interests such as you may only have to process a topic customer_bank_transfer_completed or customer_bank_transfer_failed to mark your payment record with complete / failed.

In my case, I was using the Stripe payment Intent API and integrated the webhook for it.

Here are the following steps.

  1. Create a model called Webhook and add attributes based on your requirements (like event, event_type).
  2. Create a controller called webhook_controllers.rb
  3. Write an action called create.
  4. Add route in config/routes.rb file
resources :webhooks, only :create

The migration will look like:

class CreateWebhooks < ActiveRecord::Migration[6.0]
  def change
    create_table :webhooks do |t|
      t.json :event
      t.string :event_type
      t.timestamps
    end
  end
end

Paste the following code inside webhook_controllers.rb

def create
      payload = request.body.read
      begin
        event = Stripe::Webhook.construct_event(
          payload, signature_header, endpoint_secret
        )
      rescue JSON::ParserError => e
        # Invalid payload
        render json: {success: false, message: "Invalid payload"}, status: 400 and return
      rescue Stripe::SignatureVerificationError => e
        # Invalid signature
        render json: {success: false, message: "Invalid signature"}, status: 400 and return
      end
json_data = JSON.parse(event.to_json)
      stripe_webhook = Webhook.create!(event: json_data, event_type: json_data["type"])
      render json: {success: true, message: "successfully stored"}, status: :ok
  end
private
def signature_header
      request.env['HTTP_STRIPE_SIGNATURE']
  end
def endpoint_secret
       Rails.application.credentials.stripe.dig(:webhook_endpoint_secret)
  end

You will find endpoint_secret in the stripe dashboard. First, log in to the dashboard, click on test mode then go to Developers -> Webhooks -> signing secret as shown in the image. Click to reveal.

Partner with Us for Success

Experience seamless collaboration and exceptional results.

Webhooks Signing

Add your endpoint to the stripe dashboard. suppose your URL is https://mydomain.com/webhooks and select the event that you want to receive data for. You can see in the below image.

stripe dashboard

stripe dashboard setting

After setting up everything, you can send a test webhook and test your endpoint whether it is working perfectly or not.

Partner with Us for Success

Experience seamless collaboration and exceptional results.

Conclusion

And that’s it! Did this work for you? Please leave any questions and comments below!

Thank you for reading!

If you found this article helpful, 👏👏👏

Author-Murtuza Kutub
Murtuza Kutub

A product development and growth expert, helping founders and startups build and grow their products at lightning speed with a track record of success. Apart from work, I love to Network & Travel.

Phone

Next for you

Flutter Internationalization and Localization (Multilingual Support) Cover

Technology

Apr 22, 20253 min read

Flutter Internationalization and Localization (Multilingual Support)

Flutter apps aren't bound by geographical borders, so why should your audience be? Imagine reaching users across the globe by offering your app in their language. That’s exactly what Flutter's internationalization (i18n) and localization (l10n) make possible.  According to CSA Research, 76% of consumers prefer to purchase products presented in their native language, highlighting the significant value of localization in capturing global markets. Implementing Flutter internationalization and loc

Flutter Architecture Patterns: BLoC, Provider, Riverpod, and More Cover

Technology

Apr 22, 20253 min read

Flutter Architecture Patterns: BLoC, Provider, Riverpod, and More

Flutter, Google’s innovative UI toolkit, has exploded in popularity for building beautiful, cross-platform mobile apps. But as Flutter apps scale, choosing the right architecture pattern becomes crucial. Let's make it simple and dive into the most popular Flutter architecture patterns, including BLoC, Provider, Riverpod, and beyond. Whether you're building your first Flutter app or scaling a complex project, selecting the right architecture pattern can be the difference between a maintainable a

How To Test A Flutter App? A Beginner’s Guide Cover

Technology

Apr 22, 20253 min read

How To Test A Flutter App? A Beginner’s Guide

Building a Flutter app is exciting, but what if it breaks the moment users interact with it? Testing is often skipped by beginners, but it's your app's safety net in production. But what about testing?  Whether you're just starting or looking to level up your code quality, learning how to test a Flutter app is a game-changer. This guide breaks down the basics of Flutter app testing for beginners, because writing great code is only half the job. Making sure it works is the other half. Why Test