Skip to content
This repository has been archived by the owner on Apr 8, 2024. It is now read-only.

Paddle payments integration for Google Cloud Firestore

License

Notifications You must be signed in to change notification settings

discue/paddle-integration-firestore

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Vue logo


GitHub tag Latest Stable Version License
NPM Downloads NPM Downloads
contributions - welcome Made with Node.js

paddle-integration-firestore

paddle.com payments integration for Google Cloud Firestore.

This module provides

  • a body parser function
  • a middleware function to receive and store Paddle Webhooks
  • access to the Paddle API.

It does not

  • validate webhook content. Use and register paddle-webhook-validator in your application to validate webhooks before storing them.

Installation

npm install @discue/paddle-integration-firestore

Components

Preparing a New Subscription

For the webhooks integration to work and to be able to correlate incoming hooks with the correct subscription, a placeholder needs to be created before the checkout and - afterward - a specific value must be passed to the Checkout API via the passthrough parameter. This value will be returned by the addSubscriptionPlaceholder method.

You can see in the example below, the Subscriptions constructor is called with the name of the target collection and the id of the target document. The id could be your user or api_client id. Remember: the target document must exist before creating the placeholder.

'use strict'

const readApiClient = require('./lib/your-application/read-api-client')
const paddleIntegration = require('@discue/paddle-firebase-integration')
// pass the path to the collection here
const subscriptions = new paddleIntegration.SubscriptionHooks('api_clients')

module.exports = async (req, res, next) => {
    // requires application to read api_client information 
    // based on incoming information like a JWT or a cookie
    const { id } = readApiClient(req)

    // create subscription placeholder
    const { passthrough } = await subscriptions.addSubscriptionPlaceholder([id])
    // return the passthrough to the frontend app
    res.status(200).send(JSON.stringify({ passthrough }))
}

Run E2E Tests

To run tests, run the following command

./test-e2e.sh

License

MIT