payments-with-stripe

💳 Node.js Stripe Payments Function

Receive card payments and store paid orders.

🧰 Usage

POST /checkout

This endpoint initiates a Stripe checkout session. The user ID is fetched from the headers of the request. If the user ID is not found or a Stripe checkout session could not be created, the request will be redirected to a cancel 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
successUrl	The URL to redirect to after a successful payment.	Body	String	https://example.com/success
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 Stripe checkout session URL or to the cancel URL if an error occurs

Location: https://checkout.stripe.com/pay/cs_test_...#fidkdWxOYHwnP

Location: https://mywebapp.com/cancel

POST /webhook

This endpoint is a webhook that handles Stripe event checkout.session.completed. It validates the incoming request using the Stripe's validateWebhook method. If the validation fails, a 401 response is sent.

Parameters

Name	Description	Location	Type	Sample Value
None	Webhook payload from Stripe.	Body	Object	See Stripe documentation

Response

Sample 200 Response:

In case of checkout.session.completed event, document for the order is created in Appwrite Database.

{ "success": true }

Sample 401 Response:

{ "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_DATABASE_ID

The ID of the database to store the orders.

Question	Answer
Required	No
Sample Value	main

APPWRITE_COLLECTION_ID

The ID of the collection to store the orders.

Question	Answer
Required	No
Sample Value	orders

STRIPE_SECRET_KEY

Secret for sending requests to the Stripe API.

Question	Answer
Required	Yes
Sample Value	sk_test_51J...
Documentation	Stripe: API Keys

STRIPE_WEBHOOK_SECRET

Secret used to validate the Stripe Webhook signature.

Question	Answer
Required	Yes
Sample Value	whsec_...
Documentation	Stripe: Webhooks