The platform · pay.castomapi.com
Pay
Payments between people and businesses on the platform, with Stripe underneath.
castomapi-pay takes a payment on behalf of a seller — a booking, an order, a service — through Stripe Connect, so the money lands in the seller's own account and the platform keeps only its fee. Refunds, receipts and payouts follow the seller's own rules.
It is what lets a marketplace, a booking page or a shop built on castomAPI charge a customer on day one.
Operations
| Method | Path | Description |
|---|---|---|
| GET | /public/v1/payments/{id} | What a payer may see of a payment: amount, description, state. |
| POST | /public/v1/payments/{id}/checkout | A checkout URL for an unpaid payment — the open session, or a fresh one when it has expired. `paid` when the read settled it; 409 once the payment is paid, refunded or canceled. |
| GET | /v1/payments/ | Your payments, newest first |
| POST | /v1/payments/ | Ask a customer for money and get a checkout link |
| GET | /v1/payments/{id} | One payment, and whether it is paid |
| POST | /v1/payments/{id}/cancel | Cancel an unpaid payment and kill its checkout link |
| POST | /v1/payments/{id}/refund | Refund a payment in full or in part |
| POST | /webhooks/stripe | Stripe Connect events, live mode |
| POST | /webhooks/stripe/account | Stripe events on the platform account (house sales), live mode |
| POST | /webhooks/stripe/account/test | Stripe events on the platform account (house sales), test mode |
| POST | /webhooks/stripe/test | Stripe Connect events, test mode |
Base URL: https://pay.castomapi.com · Open the live docs
The platform
Auth
One identity for every product: sign-in, sessions, OAuth clients, projects and the revocation keys every service checks.
Billing & plans
Plan entitlements for every castomo product: Stripe subscriptions in, effective quotas out, pushed to the product that enforces them.
Book
Bookings and availability: resources, slots, reservations, reminders and refunds by policy.
Events
A free global events API: what is happening where, for dashboards and sites that need a calendar they did not write.
Data
Free global reference data: countries, languages, currencies, logistics, standards — tens of millions of records, no key.
Query
Read-only SQL and document queries against the customer's own MySQL, PostgreSQL or MongoDB, from a browser, safely.