yuyz0112/public-api-skills

Overview

This skill provides a concise guide to the Stripe REST API and how to navigate its operation, resource, and schema reference files. It is intended to help developers find endpoints, understand authentication, and locate detailed request/response schemas quickly. Use it when you need to interact programmatically with Stripe or look up specific Stripe operations.

How this skill works

The skill maps Stripe API resources to individual reference files grouped under resources, operations, and schemas. Start by selecting a resource file to see available operations, then open an operation file for parameters, HTTP methods, and example requests. If an operation references a schema, open the relevant schema file for field definitions and expected types. The base URL is https://api.stripe.com/ and authentication supports basic and bearer methods.

When to use it

• Looking up the exact HTTP endpoint, method, and parameters for a Stripe feature.
• Finding request/response schema details for validation or client generation.
• Verifying authentication requirements or base URL for API calls.
• Exploring available operations for a given Stripe resource (customers, charges, invoices, etc.).
• Debugging integration issues by checking expected fields and error responses.

Best practices

• Start from the resource index to identify relevant operations before inspecting schemas.
• Use bearer tokens for production calls and rotate keys regularly for security.
• Validate requests against operation parameters and referenced schemas to prevent errors.
• Test changes in Stripe test mode and use test_helpers resources to simulate flows.
• Consult operation examples for correct header, body, and pagination usage.

Example use cases

• Create, update, and retrieve customer records and payment methods programmatically.
• Implement subscription flows by using prices, plans, subscription_items, and invoices endpoints.
• Process payments with payment_intents and confirm flows with webhooks.
• Issue refunds, handle disputes, and reconcile transactions using charges and refunds resources.
• Generate billing portals, payment links, or checkout sessions for hosted payment experiences.