FahiPay Developers

Build payments into your next idea.

Accept payments across the Maldives with hosted checkout and PayMV QR. Connect customer-approved billing and wallet information to your website, app, or business software.

Read the docs Download openapi.json Brand assets Merchant credentials

Create a hosted payment link

Request

curl https://api.fahipay.mv/merchants/payments \
  -H "X-API-Key: YOUR_SECRET_KEY" \
  -H "Idempotency-Key: ORDER-2026-001" \
  -H "Content-Type: application/json" \
  -d '{
    "reference": "ORDER-2026-001",
    "amount": 24900,
    "title": "Order #001"
  }'

Response excerpt

{
  "id": "<payment_uuid>",
  "reference": "ORDER-2026-001",
  "amount": 24900,
  "payment_url": "<hosted checkout link>",
  "qr_url": "<paymv qr link>"
}

Amounts are in laari. In this example, 24,900 laari = MVR 249.00.

Choose the API you need

Use the Merchant API to accept customer payments. Use the Wallet API to access your personal account balances, usage, and transaction history.

Live

Merchant API

Create hosted payment links and PayMV QR codes, track payments, and collect payments under customer-approved authorizations.

Explore Merchant API

Live

Wallet API

Read wallet balances, transaction history, and usage limits for personal FahiPay accounts using an API key.

Explore Wallet API

OpenAPI

Import into tools

Use the combined OpenAPI file with Postman, Swagger UI, or other OpenAPI-compatible development tools.

Download openapi.json

Built for everyday payment flows

From a single checkout to recurring billing, connect the payment features your customers need.

Hosted paymentsLive

Create a checkout link or PayMV QR code, then track the payment until it is paid, expired, cancelled, or refunded.

Payment requestsLive

Send a payment request using a customer’s mobile number, email address, or FahiPay virtual payment address (VPA).

AuthorizationsLive

Collect customer approval for subscriptions, gym memberships, or usage-based billing, within the limits they approve.

WebhooksLive

Receive signed webhook notifications when payments, authorizations, or payment requests change. Follow the documentation to verify each notification.

Wallet informationLive

Read account balances, usage limits, and paginated transaction history for personal accounts.