What can you do with it?

The Stripe API allows you to manage payment processing and subscription billing. You can create and manage customers, set up products and pricing plans, handle subscriptions, track balance transactions, and manage your entire payment infrastructure programmatically.

How to use it?

Basic Command Structure

/your-stripe-connection [action] [required-parameters] [optional-parameters]

Parameters

Required:

  • action - The action to perform (create, update, get, list)
  • entity - The entity type (customer, subscription, product, etc.)
  • id - Entity ID for specific operations

Optional:

  • email - Customer email address
  • name - Customer or product name
  • description - Description for entities
  • amount - Price amount in cents
  • currency - Currency code (e.g., “usd”)
  • interval - Billing interval (month, year)

Tools

Create Customer

Create a new customer in Stripe.

Parameters:

  • email (required) - Customer email address
  • name (required) - Customer name
  • description (optional) - Customer description

Example:

/your-stripe-connection
action: create
entity: customer
email: customer@example.com
name: John Doe
description: New customer for subscription service

Response:

{
  "id": "cus_1234567890",
  "object": "customer",
  "email": "customer@example.com",
  "name": "John Doe",
  "description": "New customer for subscription service"
}

Update Customer

Update an existing customer’s information in Stripe.

Parameters:

  • customer_id (required) - Customer ID to update
  • name (optional) - Updated customer name
  • description (optional) - Updated description
  • email (optional) - Updated email address

Example:

/your-stripe-connection
action: update
entity: customer
customer_id: cus_1234567890
name: Jane Doe
description: Updated customer information

Response:

{
  "id": "cus_1234567890",
  "object": "customer",
  "email": "customer@example.com",
  "name": "Jane Doe",
  "description": "Updated customer information"
}

Get Customer

Retrieve a customer’s details by their unique ID.

Parameters:

  • customer_id (required) - Customer ID to retrieve

Example:

/your-stripe-connection
action: get
entity: customer
customer_id: cus_1234567890

Response:

{
  "id": "cus_1234567890",
  "object": "customer",
  "email": "customer@example.com",
  "name": "Jane Doe",
  "description": "Updated customer information"
}

List Customers

Retrieve a list of customers.

Parameters:

  • limit (optional) - Number of customers to return
  • starting_after (optional) - Customer ID to start after

Example:

/your-stripe-connection
action: list
entity: customers
limit: 10

Response:

{
  "object": "list",
  "data": [
    {
      "id": "cus_1234567890",
      "object": "customer",
      "email": "customer1@example.com",
      "name": "Customer One"
    },
    {
      "id": "cus_0987654321",
      "object": "customer",
      "email": "customer2@example.com",
      "name": "Customer Two"
    }
  ]
}

Create Subscription

Create a new subscription for an existing customer.

Parameters:

  • customer_id (required) - Customer ID for the subscription
  • price_id (required) - Price ID for the subscription
  • trial_period_days (optional) - Trial period in days

Example:

/your-stripe-connection
action: create
entity: subscription
customer_id: cus_1234567890
price_id: price_1234567890
trial_period_days: 14

Response:

{
  "id": "sub_1234567890",
  "object": "subscription",
  "customer": "cus_1234567890",
  "status": "active",
  "items": {
    "object": "list",
    "data": [
      {
        "id": "si_1234567890",
        "object": "subscription_item",
        "price": {
          "id": "price_1234567890",
          "object": "price",
          "product": "prod_1234567890"
        }
      }
    ]
  }
}

List Subscriptions

Retrieve a list of subscriptions.

Parameters:

  • customer_id (optional) - Filter by specific customer
  • status (optional) - Filter by subscription status
  • limit (optional) - Number of subscriptions to return

Example:

/your-stripe-connection
action: list
entity: subscriptions
customer_id: cus_1234567890
status: active

Response:

{
  "object": "list",
  "data": [
    {
      "id": "sub_1234567890",
      "object": "subscription",
      "customer": "cus_1234567890",
      "status": "active"
    },
    {
      "id": "sub_0987654321",
      "object": "subscription",
      "customer": "cus_0987654321",
      "status": "canceled"
    }
  ]
}

Create Product

Create a new product in Stripe.

Parameters:

  • name (required) - Product name
  • description (optional) - Product description
  • active (optional) - Whether the product is active

Example:

/your-stripe-connection
action: create
entity: product
name: Premium Plan
description: Access to all premium features
active: true

Response:

{
  "id": "prod_1234567890",
  "object": "product",
  "name": "Premium Plan",
  "description": "Access to all premium features",
  "active": true
}

Get Product

Retrieve a product’s details by its unique ID.

Parameters:

  • product_id (required) - Product ID to retrieve

Example:

/your-stripe-connection
action: get
entity: product
product_id: prod_1234567890

Response:

{
  "id": "prod_1234567890",
  "object": "product",
  "name": "Premium Plan",
  "description": "Access to all premium features",
  "active": true
}

List Products

Retrieve a list of products available in Stripe.

Parameters:

  • active (optional) - Filter by active status
  • limit (optional) - Number of products to return

Example:

/your-stripe-connection
action: list
entity: products
active: true
limit: 10

Response:

{
  "object": "list",
  "data": [
    {
      "id": "prod_1234567890",
      "object": "product",
      "name": "Premium Plan",
      "description": "Access to all premium features",
      "active": true
    },
    {
      "id": "prod_0987654321",
      "object": "product",
      "name": "Basic Plan",
      "description": "Access to basic features",
      "active": true
    }
  ]
}

List Balance Transactions

Retrieve a list of balance transactions for the account.

Parameters:

  • type (optional) - Filter by transaction type
  • limit (optional) - Number of transactions to return
  • starting_after (optional) - Transaction ID to start after

Example:

/your-stripe-connection
action: list
entity: balance_transactions
type: payment
limit: 10

Response:

{
  "object": "list",
  "data": [
    {
      "id": "txn_1234567890",
      "object": "balance_transaction",
      "amount": 10000,
      "currency": "usd",
      "description": "Payout",
      "status": "available",
      "type": "payment"
    },
    {
      "id": "txn_0987654321",
      "object": "balance_transaction",
      "amount": -5000,
      "currency": "usd",
      "description": "Refund",
      "status": "pending",
      "type": "refund"
    }
  ]
}

List Plans

Retrieve a list of pricing plans available in Stripe.

Parameters:

  • product_id (optional) - Filter by specific product
  • active (optional) - Filter by active status
  • limit (optional) - Number of plans to return

Example:

/your-stripe-connection
action: list
entity: plans
product_id: prod_1234567890
active: true

Response:

{
  "object": "list",
  "data": [
    {
      "id": "plan_1234567890",
      "object": "plan",
      "amount": 1000,
      "currency": "usd",
      "interval": "month",
      "product": "prod_1234567890",
      "active": true
    },
    {
      "id": "plan_0987654321",
      "object": "plan",
      "amount": 5000,
      "currency": "usd",
      "interval": "year",
      "product": "prod_0987654321",
      "active": true
    }
  ]
}

Notes

All requests require the Content-Type header set to “application/x-www-form-urlencoded”. Amounts are specified in the smallest currency unit (cents for USD). Supports both PinkConnect and Paragon proxy connections. Customer IDs, subscription IDs, and product IDs are required for specific operations. Balance transactions show all money movement in your Stripe account.