Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/adityaoberai/payments-lemon-squeezy-appwrite-function
Appwrite Function to receive payments in Lemon Squeezy and store paid orders.
https://github.com/adityaoberai/payments-lemon-squeezy-appwrite-function
appwrite lemon-squeezy payments
Last synced: 7 days ago
JSON representation
Appwrite Function to receive payments in Lemon Squeezy and store paid orders.
- Host: GitHub
- URL: https://github.com/adityaoberai/payments-lemon-squeezy-appwrite-function
- Owner: adityaoberai
- Created: 2024-04-08T20:32:29.000Z (9 months ago)
- Default Branch: main
- Last Pushed: 2024-04-12T11:45:13.000Z (9 months ago)
- Last Synced: 2024-10-30T10:47:18.278Z (about 2 months ago)
- Topics: appwrite, lemon-squeezy, payments
- Language: HTML
- Homepage:
- Size: 15.6 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# 💳 Node.js Lemon Squeezy Payments Function
Appwrite Function to receive payments in Lemon Squeezy and store paid orders.
## 🧰 Usage
### `POST /checkout`
This endpoint creates a Lemon Squeezy checkout. The user ID is fetched from the headers of the request. If the user ID is not found or a Lemon Squeezy checkout fails, the request will be redirected to a failure URL.
**Parameters**
| Name | Description | Location | Type | Sample Value |
| ------------------ | --------------------------------------------------------- | -------- | ------------------ | --------------------------- |
| x-appwrite-user-id | User ID from Appwrite. | Header | String | 642...7cd |
| Content-Type | The content type of the request body | Header | `application/json` | N/A |
| failureUrl | The URL to redirect to after a cancelled payment attempt. | Body | String | https://example.com/failure |
**Response**
Sample `303` Response:
The response is a redirect to the Lemon Squeezy checkout URL or to the failure URL if an error occurs
```text
Location: https://ap...re.lemonsqueezy.com/checkout/custom/7576abf3-...e2fb
```
```text
Location: https://mywebapp.com/cancel
```
### `POST /webhook`
This endpoint is a webhook that handles Lemon Squeezy event `order_created`. It validates the incoming request using the `X-Signature` header from the Lemon Squeezy webhook. If the validation fails, a `401` response is sent.
**Parameters**
| Name | Description | Location | Type | Sample Value |
| ----------- | ----------------------------------- | -------- | ------ | ------------------------------------------------------------------------------------------------------------------------------- |
| None | Webhook payload from Lemon Squeezy. | Body | Object | [See Lemon Squeezy docs](https://docs.lemonsqueezy.com/api/orders#the-order-object) |
| x-signature | Signature from Lemon Squeezy. | Headers | String | [See Lemon Squeezy docs](https://docs.lemonsqueezy.com/guides/developer-guide/webhooks#signing-and-validating-webhook-requests) |
**Response**
Sample `200` Response:
In case of `order_created` event, document for the order is created in Appwrite Database.
```json
{ "success": true }
```
Sample `401` Response:
```json
{ "success": false }
```
## ⚙️ Configuration
| Setting | Value |
| ----------------- | ------------------------------ |
| Runtime | Node (18.0) |
| Entrypoint | `src/main.js` |
| Build Commands | `npm install && npm run setup` |
| Permissions | `any` |
| Timeout (Seconds) | 15 |
> If using a demo web app to create order, make sure to add your function domain as a web platform to your Appwrite project. Doing this fixes CORS errors and allows proper functionality.
## 🔒 Environment Variables
### APPWRITE_API_KEY
Your Appwrite project's API key.
| Question | Answer |
| ------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Required | Yes |
| Sample Value | `083d341ee48...` |
| Documentation | [Appwrite: Create an API key](https://appwrite.io/docs/advanced/platform/api-keys#:~:text=To%20create%20a%20new%20API,scope%20to%20grant%20your%20application.) |
### APPWRITE_ENDPOINT
The endpoint where your Appwrite server is located. If not provided, it defaults to the Appwrite Cloud server: `https://cloud.appwrite.io/v1`.
| Question | Answer |
| ------------ | ------------------------------ |
| Required | No |
| Sample Value | `https://cloud.appwrite.io/v1` |
### APPWRITE_DATABASE_ID
The ID of the database to store the orders.
| Question | Answer |
| ------------ | -------- |
| Required | No |
| Sample Value | `orders` |
### APPWRITE_COLLECTION_ID
The ID of the collection to store the orders.
| Question | Answer |
| ------------ | -------- |
| Required | No |
| Sample Value | `orders` |
### LEMON_SQUEEZY_API_KEY
API key for sending requests to the Lemon Squeezy API.
| Question | Answer |
| ------------- | --------------------------------------------------------------------------- |
| Required | Yes |
| Sample Value | `eyJ0eXAiOiJ...` |
| Documentation | [Lemon Squeezy: API Keys](https://docs.lemonsqueezy.com/api#authentication) |
### LEMON_SQUEEZY_WEBHOOK_SECRET
Secret used to validate the Lemon Squuezy Webhook signature.
| Question | Answer |
| ------------- | ----------------------------------------------------------------------------------------------------------- |
| Required | Yes |
| Sample Value | `abcd...` |
| Documentation | [Lemon Squeezy: Webhooks](https://docs.lemonsqueezy.com/guides/developer-guide/webhooks#from-the-dashboard) |
### LEMON_SQUEEZY_STORE_ID
Store ID required to create a checkout using the Lemon Squeezy API.
| Question | Answer |
| ------------- | -------------------------------------------------------------------------------------------------------------------------------- |
| Required | Yes |
| Sample Value | `123456` |
| Documentation | [Lemon Squeezy: Checkouts](https://docs.lemonsqueezy.com/guides/developer-guide/taking-payments#creating-checkouts-with-the-api) |
### LEMON_SQUEEZY_VARIANT_ID
Variant ID of a product required to create a checkout using the Lemon Squeezy API.
| Question | Answer |
| ------------- | -------------------------------------------------------------------------------------------------------------------------------- |
| Required | Yes |
| Sample Value | `123456` |
| Documentation | [Lemon Squeezy: Checkouts](https://docs.lemonsqueezy.com/guides/developer-guide/taking-payments#creating-checkouts-with-the-api) |