https://github.com/uniquelyparticular/sync-stripe-to-zendesk
This Particular example demonstrates how you can sync payment refunds from Stripe into Zendesk Sunshine via Webhook API.
https://github.com/uniquelyparticular/sync-stripe-to-zendesk
crm ecommerce integration microservices particular payment stripe sunshine webhooks zendesk
Last synced: 8 days ago
JSON representation
This Particular example demonstrates how you can sync payment refunds from Stripe into Zendesk Sunshine via Webhook API.
- Host: GitHub
- URL: https://github.com/uniquelyparticular/sync-stripe-to-zendesk
- Owner: uniquelyparticular
- License: mit
- Created: 2019-03-20T06:22:36.000Z (over 6 years ago)
- Default Branch: master
- Last Pushed: 2025-06-19T11:49:56.000Z (4 months ago)
- Last Synced: 2025-06-19T12:39:05.189Z (4 months ago)
- Topics: crm, ecommerce, integration, microservices, particular, payment, stripe, sunshine, webhooks, zendesk
- Language: JavaScript
- Homepage: https://uniquelyparticular.com
- Size: 784 KB
- Stars: 1
- Watchers: 3
- Forks: 0
- Open Issues: 102
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# @particular./sync-stripe-to-zendesk
[](https://www.npmjs.com/package/@particular./sync-stripe-to-zendesk) [](https://github.com/semantic-release/semantic-release) [](https://github.com/prettier/prettier) [](https://circleci.com/gh/uniquelyparticular/sync-stripe-to-zendesk)
> Add a Zendesk Sunshine Event when payment refunded in Stripe
Asynchronous microservice that is triggered by [Stripe](https://stripe.com) webhooks to create a Sunshine Event inside of [Zendesk](https://zendesk.com).
⚠️ Zendesk [Sunshine Event API](https://develop.zendesk.com/hc/en-us/community/posts/360004233828-About-the-Events-API) is only available via Early Access BETA registration.
Built with [Micro](https://github.com/zeit/micro)! 🤩
## 🛠 Setup
Both a [Zendesk](https://zendesk.com) _and_ [Stripe](https://stripe.com) account are needed for this to function.
Create a `.env` at the project root with the following credentials:
```dosini
STRIPE_SECRET_KEY=
STRIPE_WEBHOOK_SECRET=
ZENDESK_SUBDOMAIN=
ZENDESK_INTEGRATION_EMAIL=
ZENDESK_INTEGRATION_SECRET=
```
Find your `STRIPE_SECRET_KEY` within Stripe's [API Settings](https://dashboard.stripe.com/account/apikeys).
`ZENDESK_SUBDOMAIN` is the first part of the URL for your Zendesk account (ie. https://{ZENDESK_SUBDOMAIN}.zendesk.com/).
While logged in to your Zendesk instance create a new User to run the Webhooks under by going to `Settings` > `People` > `Add User` > `Role: Staff`; this email address will be used as your `ZENDESK_INTEGRATION_EMAIL` above.
Find your `ZENDESK_INTEGRATION_SECRET` within your Zendesk instance by going to `Settings` > `API` > enable `Token Access` > add `Active API Tokens [+]` > `API Token`.
## 📦 Package
Run the following command to build the app
```bash
yarn install
```
Start the development server
```bash
yarn dev
```
The server will typically start on PORT `3000`, if not, make a note for the next step.
Start ngrok (change ngrok port below from 3000 if yarn dev deployed locally on different port above)
```bash
ngrok http 3000
```
Make a note of the https `ngrok URL` provided.
## ⛽️ Usage
Next head over to the Stripe [Webhook Settings](https://dashboard.stripe.com/account/webhooks) area, add a new webhook with the following details:
| URL to be called | Webhook version | Filter event |
| ------------------- | ---------------------- | ------------------------------------------ |
| _`ngrok URL` above_ | `2018-05-21 (Default)` | 'Select types to send' > `charge.refunded` |
## 🚀 Deploy
You can easily deploy this function to [now](https://now.sh).
_Contact [Adam Grohs](https://www.linkedin.com/in/adamgrohs/) @ [Particular.](https://uniquelyparticular.com) for any questions._