# Stripe API

**Provider:** Stripe
**Category:** payments
**Base URL:** `https://api.stripe.com/v1`
**Auth:** basic — `Authorization: Basic base64(sk_live_...)`
**Rate Limit:** 100 read / 100 write requests/s
**Free Tier:** Yes — available
**Pricing:** Pay per use (pay-as-you-go)
**Docs:** https://stripe.com/docs/api

## Description

Stripe's API powers payments for millions of businesses. Accept cards, bank transfers, wallets, and 135+ currencies. Build subscription billing, usage-based pricing, invoicing, and marketplace payouts. Webhook-driven architecture with idempotency for reliability.

## Endpoints

| Method | Endpoint | Description |
|--------|----------|-------------|
| POST | `https://api.stripe.com/v1/payment_intents` | Create a PaymentIntent |
| POST | `https://api.stripe.com/v1/payment_intents/{id}/confirm` | Confirm a PaymentIntent |
| POST | `https://api.stripe.com/v1/customers` | Create a customer |
| POST | `https://api.stripe.com/v1/subscriptions` | Create a subscription |
| POST | `https://api.stripe.com/v1/invoices` | Create an invoice |
| GET | `https://api.stripe.com/v1/charges` | List all charges |
| POST | `https://api.stripe.com/v1/refunds` | Create a refund |
| POST | `https://api.stripe.com/v1/webhook_endpoints` | Register a webhook endpoint |

## Authentication

Use HTTP Basic Auth with your secret key as the username. No password needed.

```
Authorization: Basic base64(sk_live_...)
```

## Sample Request

```bash
curl https://api.stripe.com/v1/payment_intents \
  -u "sk_test_4eC39HqLyjWDarjtT1zdp7dc:" \
  -d amount=2000 \
  -d currency=usd \
  -d "payment_method_types[]"=card
```

## Sample Response

```json
{
  "id": "pi_3MtwBwLkdIwHu7ix28a3tqPa",
  "object": "payment_intent",
  "amount": 2000,
  "currency": "usd",
  "status": "requires_payment_method",
  "client_secret": "pi_3Mtw..._secret_...",
  "created": 1680800504
}
```

## Pricing Details

Online cards: 2.9% + $0.30/transaction. In-person: 2.7% + $0.05. Stripe Connect: +0.25% + $0.25/transfer. Custom pricing for volume.

---

*Source: [API Map](https://apimap.dev/apis/stripe/) — CC BY 4.0*