@frogbotai/piece-stripe 0.22.0 → 0.23.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md ADDED
@@ -0,0 +1,57 @@
1
+ # `@frogbotai/piece-stripe`
2
+
3
+ Manage Stripe customers, billing resources, payments, and webhook events.
4
+
5
+ ## Usage
6
+
7
+ ```ts
8
+ import { createStripe } from '@frogbotai/piece-stripe';
9
+
10
+ export const stripe = createStripe({ auth: { apiKey: process.env.STRIPE_SECRET_KEY! } });
11
+ ```
12
+
13
+ ## Actions
14
+
15
+ | Upstream action slug | Previous wrapper export | Native action | Notes |
16
+ | ------------------------- | ----------------------- | ----------------------- | -------------------------------------------- |
17
+ | `create_customer` | `createCustomer` | `createCustomer` | |
18
+ | `create_invoice` | `createInvoice` | `createInvoice` | |
19
+ | `search_customer` | `searchCustomer` | `searchCustomers` | Semantic plural search result. |
20
+ | `search_subscriptions` | `searchSubscriptions` | `searchSubscriptions` | Was omitted from wrapper defaults. |
21
+ | `retrieve_customer` | `retrieveCustomer` | `getCustomer` | Semantic get-by-ID name. |
22
+ | `update_customer` | `updateCustomer` | `updateCustomer` | Was omitted from wrapper defaults. |
23
+ | `create_payment_intent` | `createPaymentIntent` | `createPaymentIntent` | Was omitted from wrapper defaults. |
24
+ | `create_product` | `createProduct` | `createProduct` | Was omitted from wrapper defaults. |
25
+ | `create_price` | `createPrice` | `createPrice` | Was omitted from wrapper defaults. |
26
+ | `create_subscription` | `createSubscription` | `createSubscription` | Was omitted from wrapper defaults. |
27
+ | `cancel_subscription` | `cancelSubscription` | `cancelSubscription` | Was omitted from wrapper defaults. |
28
+ | `retrieve_invoice` | `retrieveInvoice` | `getInvoice` | Uses dynamic invoice choices. |
29
+ | `retrieve_payout` | `retrievePayout` | `getPayout` | Was omitted from wrapper defaults. |
30
+ | `create_refund` | `createRefund` | `createRefund` | |
31
+ | `create_payment_link` | `createPaymentLink` | `createPaymentLink` | |
32
+ | `deactivate_payment_link` | `deactivatePaymentLink` | `deactivatePaymentLink` | Was omitted from wrapper defaults. |
33
+ | `retrieve_payment_intent` | `retrievePaymentIntent` | `getPaymentIntent` | Semantic get-by-ID name. |
34
+ | `find_invoice` | `findInvoice` | `findInvoice` | Explicit ID variant without dynamic choices. |
35
+ | `custom_api_call` | `customApiCall` | `sendRequest` | Authenticated Stripe `/v1` request. |
36
+
37
+ ## Triggers
38
+
39
+ | Upstream trigger slug | Native trigger | Type | Stripe event |
40
+ | ---------------------------- | ---------------------- | --------- | ------------------------------- |
41
+ | `new_payment` | `paymentSucceeded` | `webhook` | `payment_intent.succeeded` |
42
+ | `new_customer` | `customerCreated` | `webhook` | `customer.created` |
43
+ | `payment_failed` | `paymentFailed` | `webhook` | `charge.failed` |
44
+ | `new_subscription` | `subscriptionCreated` | `webhook` | `customer.subscription.created` |
45
+ | `new_charge` | `chargeSucceeded` | `webhook` | `charge.succeeded` |
46
+ | `new_invoice` | `invoiceCreated` | `webhook` | `invoice.created` |
47
+ | `invoice_payment_failed` | `invoicePaymentFailed` | `webhook` | `invoice.payment_failed` |
48
+ | `canceled_subscription` | `subscriptionCanceled` | `webhook` | `customer.subscription.deleted` |
49
+ | `new_refund` | `refundCreated` | `webhook` | `refund.created` |
50
+ | `new_dispute` | `disputeCreated` | `webhook` | `charge.dispute.created` |
51
+ | `new_payment_link` | `paymentLinkCreated` | `webhook` | `payment_link.created` |
52
+ | `updated_subscription` | `subscriptionUpdated` | `webhook` | `customer.subscription.updated` |
53
+ | `checkout_session_completed` | `checkoutCompleted` | `webhook` | `checkout.session.completed` |
54
+
55
+ Stripe creates a dedicated webhook endpoint for each enabled trigger. FrogBot stores its endpoint ID and signing secret, verifies `Stripe-Signature` against the unchanged request body, and removes the endpoint when the trigger is disabled.
56
+
57
+ Optional filters are available on `invoiceCreated` (`status`, `customerId`, `subscriptionId`), `invoicePaymentFailed`, `subscriptionCanceled`, and `checkoutCompleted` (`customerId`), `refundCreated` and `disputeCreated` (`chargeId`, `paymentIntentId`), and `subscriptionUpdated` (`status`, `customerId`).