MagicStack Payment Documentation

This service handles payment-provider checkout creation and webhook normalization. Your application owns order creation and fulfilment logic.

1. Create your own order endpoint in your backend, create the order, then call POST /payment with tenant headers and payment payload.
2. Configure tenant setup with API key, tenant/auth secrets, and tenant properties (including provider and redirect props).
3. Use redirect URL returned by this service and send it to your frontend so the user is redirected to checkout.
4. Provider redirects back to your success/cancel pages configured in tenant properties.
5. Show payment status screen and let the user continue based on your business flow.
6. Create /payment/webhook in your backend to process final payment updates and update your order (credits, tickets, subscriptions, etc.).

Method	Endpoint	Purpose
POST	/payment	Create checkout using tenant default provider
POST	/yoco	Create checkout explicitly with Yoco
POST	/stripe	Create checkout explicitly with Stripe
POST	/paystack	Create checkout explicitly with Paystack
POST	/yoco/webhook	Provider webhook receiver (Yoco)
POST	/stripe/webhook	Provider webhook receiver (Stripe)
POST	/paystack/webhook	Provider webhook receiver (Paystack)
POST	/webhooks	Register your downstream webhook endpoint
GET	/health	Service health check