[ Apps & platforms ]
Payments for your AI app,
in one API.
Sell access to your AI app, bot or SaaS with a Stripe-compatible REST API. Ripey hosts the checkout and tells your server when a payment is verified.
01 / Integrate
Create a checkout. Trust the webhook.
If you’ve built on Stripe, you already know the objects.
curl https://pay.ripey.app/v1/checkout/sessions \
-H "x-api-key: $RIPEY_SECRET_KEY" \
-H "content-type: application/json" \
-d '{
"mode": "payment",
"line_items": [{ "price": "price_z_...", "quantity": 1 }],
"success_url": "https://yourapp.com/thanks",
"client_reference_id": "user_42"
}'
# → { "id": "cs_z_...", "url": "https://pay.ripey.app/c/..." }// On checkout.session.completed, grant access to the user in client_reference_id.
const event = verifyRipeyEvent(rawBody, req.headers["zoneless-signature"], process.env.RIPEY_WEBHOOK_SECRET);
if (event.type === "checkout.session.completed" && event.data.object.payment_status === "paid") {
await grantAccess(event.data.object.client_reference_id);
}The full signature check is on the developers page.
02 / Steps
Four steps to your first payment.
- Get a test keyOpen a store, then Dashboard → Developers → API keys. Test keys start with sk_test_.
- Create a product and priceAmounts are in cents: 2900 = 29.00 USDC.
- Create a checkoutFrom your server, then redirect the buyer to the hosted payment page.
- Fulfil from the webhookGrant access when the signed checkout.session.completed event arrives.
03 / Reference
The essentials.
- Base URL
https://pay.ripey.app/v1- Auth
- An
x-api-keyheader with your secret key. Keep it on your server. - Format
- JSON request and response bodies.
- Objects
- Products, prices, checkout sessions, payment links, customers and events, shaped like Stripe’s.
- Webhooks
- HMAC-SHA256 signatures over “<timestamp>.<raw body>”, in the Zoneless-Signature header.
- Settlement
- USDC on Solana, paid straight to your wallet. Ripey never holds the funds.
04 / Status
What works today.
No backend? A one-line pay button or a payment link works too.
Available now Test mode
- REST API with test keys
- Hosted checkout
- Payment links
- Signed webhooks
- Pay button for any website
- USDC on Solana
On the roadmap Planned
- Credit and debit card payments
- Multiple payment providers and orchestration
- Revenue sharing for platforms
- Seller onboarding and KYC