Payments docs

Payments API reference

Charges, refunds, subscriptions, invoices, payment methods, and webhook-ready billing flows

/api/payments8 endpointsPagination + delay readyDownload OpenAPI JSONDownload OpenAPI YAMLDownload Postman Collection

Endpoints

Pick the route you want to test.

8 routes

Active selection

GET

/api/payments/stripe?customer_id=cus_123

Sample request

JAVASCRIPT example
1const payload = {
2  "example": "payload"
3}
4fetch('https://fakeapifordevs.vercel.app/api/payments/stripe?customer_id=cus_123&page=1&per_page=5&delay=1', {
5  method: 'GET',
6  headers: { 'Content-Type': 'application/json' }
7})
8  .then(res => res.json())
9  .then(console.log)

Response contract

List responses include pagination metadata and can surface latency information when you add the `delay` query parameter.

Sample response
1{
2  "data": [
3    {
4      "id": "py_123-1",
5      "amount": 4999,
6      "currency": "usd",
7      "status": "succeeded"
8    },
9    {
10      "id": "py_123-2",
11      "amount": 4999,
12      "currency": "usd",
13      "status": "succeeded"
14    }
15  ],
16  "pagination": {
17    "page": 1,
18    "perPage": 5,
19    "total": 42,
20    "totalPages": 9
21  },
22  "meta": {
23    "delayMs": 0
24  }
25}

Query controls

These parameters are supported consistently across collection routes.

page

1-indexed page number. Defaults to 1.

per_page

Number of records per page. Defaults to 10, max 50.

q

Optional text search against names, titles, descriptions, or tags where supported.

delay

Simulate latency in seconds (max 10s).

simulate_error

Force realistic failures like 429, 500, 401, or 503 for resilience testing.

pagination_style

Switch between page, cursor, and link-style pagination on supported collections.

cors

Use `cors=restrict` or `cors=preflight` to test browser integration edge cases.

Integration checklist

  • Use `page` and `per_page` when you need predictable list states.
  • Append `delay` to mimic loading and partial-rendering moments.
  • Point internal examples and SDKs to `/api/payments`.
  • Deep-link the selected method and path when sharing review links.

Playground shortcut

Open the landing page playground with this exact route already selected.

Open playground

https://fakeapifordevs.vercel.app/api/payments/stripe?customer_id=cus_123&page=1&per_page=5&delay=1

Need another domain?

Explore the rest of the library without leaving the docs system.

AuthenticationE-commerceReal EstateSocial MediaFood DeliverySaaS

Keep these docs online

Buy the maintainers a coffee

Coffee donations help us keep Payments accurate, readable, and easier to test with every release.

  • Covers upkeep for payments docs
  • Funds schema QA sprints
Buy us a coffee

Explore other domains

AuthenticationE-commerceReal EstateSocial MediaFood DeliverySaaSLogisticsWeather