Get started

Quickstart

Deploy, pair a phone and take your first payment.

This guide takes you from a fresh server to a verified MoMo payment. If we are deploying LokiPay for you, we do steps 1–2 and hand you the dashboard.

Point a domain at your server

Create a DNS A record such as pay.yourshop.com → your server’s IP address. Any Linux server with Docker works — see requirements.

Deploy LokiPay

from the lokipay-admin repository

cat > deploy.env <<EOF
REMOTE_HOST=203.0.113.10
DOMAIN=pay.yourshop.com
SSL_EMAIL=you@yourshop.com
EOF
./deploy.sh

The first run asks you to create /var/www/lokipay/.env on the server from .env.example (secrets never leave the server). Run ./deploy.sh again and LokiPay comes up with HTTPS. Details: Deploy with Docker.

Configure the dashboard

Receiving account — the MoMo number or merchant ID customers pay into, and the name on it.
Branding — your business name, colour and logo.
Webhook and API keys — only if your app will create payments by API.

Pair the MoMo phone

Install the LokiPay Relay app on the phone with the MoMo SIM (download it from https://pay.yourshop.com/download), then in the dashboard go to Relay phones → Pair a phone and scan the QR code. Allow SMS access and notifications. See Install & pair.

Take a payment

Create a payment link in Payment links → New link, open it on your phone, and pay the amount with the reference shown. Within seconds the page shows Payment confirmed and the payment appears under Payments.

Prefer code? Create a payment from your backend and redirect the customer to its checkoutUrl:

curl https://pay.yourshop.com/v1/intents \
  -H "Authorization: Bearer $LOKIPAY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"reference":"ORDER-1001","amountPesewas":15000,"description":"Order #1001"}'

Test without a real transfer: in MoMo SMS → Paste SMS you can paste a real payment SMS. It goes through the same parser and matching as one from the relay phone.

Introduction

Core concepts