mavi pay Documentation

Welcome to the mavi pay documentation. mavi pay is a merchant payment platform that lets you accept one-time and recurring payments, manage subscriptions, deliver digital benefits, and get paid out via Stripe Connect -- all with a flat 2% transaction fee.

mavi pay is built and operated from Flanders, Belgium, and is fully EU/GDPR compliant.

Getting Started

Before diving in, create your merchant account at pay.mavifinans.sh/dashboard. You will need to complete onboarding and connect your Stripe account to start accepting payments.

Features

Products and Subscriptions

Create one-time and recurring products. Set pricing, manage inventory, and organise your catalogue from the merchant dashboard.

Checkouts

Accept payments through hosted checkout pages, shareable checkout links, and embeddable checkout widgets. Customise the checkout experience to match your brand.

Checkout Links

Generate unique links to any product or checkout session. Share them on social media, embed them in emails, or place them on your website.

Benefits

Attach digital entitlements to your products -- license keys, file downloads, Discord server access, and custom benefits. Automatically delivered upon purchase.

Usage-Based Billing

Meter customer usage, ingest events via API, and bill customers based on actual consumption per billing cycle.

Customer Management

View customer profiles, order history, active subscriptions, and lifetime value. Export customer data and manage subscriptions on their behalf.

Finance and Payouts

Track your revenue, view payout schedules, and manage your earnings. Payouts are processed via Stripe Connect directly to your bank account.

Integrate

Next.js

Server and client-side integration with Next.js using @mavi-pay/sdk.

BetterAuth

Authenticate and gate content using BetterAuth with mavi pay entitlements.

Hono

Lightweight integration for Hono-based APIs and edge functions.

Laravel

Server-side integration for Laravel applications using the mavi pay PHP SDK.

API Reference

The mavi pay API is available at https://api.mavifinans.sh. All endpoints require authentication via your API key, which you can generate in the dashboard under Settings.

Base URL: https://api.mavifinans.sh/api/v1

Authentication: Bearer token via Authorization: Bearer <your-api-key> header.

Support

If you have questions or need help, reach out to us at mavifinans.sh/contact.