NewDash Dots are hereMini apps in Dash, with payments built inLearn more

Monime Documentation

Let's build better financial products together.

Monime gives you one programmable API to build financial products on Mobile Money, cards, banks and digital wallets. Accept payments, send payouts and manage accounts. Explore guides, examples and the API reference to start building.

# Creates a payment page hosted by Monime and returns its link
curl https://api.monime.io/v1/checkout-sessions \
  -H "Authorization: Bearer $MONIME_ACCESS_TOKEN" \
  -H "Monime-Space-Id: $MONIME_SPACE_ID" \
  -H "Idempotency-Key: order-1042" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Order #1042",
    "lineItems": [{
      "type": "custom",
      "name": "Event ticket",
      "quantity": 1,
      "price": { "currency": "SLE", "value": 25000 }
    }],
    "metadata": { "event": "Kenema Music Festival" }
  }'
# Creates a USSD code to pay with mobile money e.g. *715*123456#
curl https://api.monime.io/v1/payment-codes \
  -H "Authorization: Bearer $MONIME_ACCESS_TOKEN" \
  -H "Monime-Space-Id: $MONIME_SPACE_ID" \
  -H "Idempotency-Key: order-1042" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Order #1042",
    "mode": "one_time",
    "amount": { "currency": "SLE", "value": 25000 },
    "duration": "30m",
    "authorizedProviders": ["m17", "m18"],
    "reference": "order-1042",
    "metadata": { "event": "Kenema Music Festival" }
  }'
// Asks the customer to pay in Dash with the method they choose
const payment = await this.dash.payments.request({
  order: {
    name: 'Order #1042',
    reference: 'order-1042',
    lineItems: [{
      name: 'Event ticket',
      quantity: 1,
      unitPrice: { currency: 'SLE', value: 25000 },
    }],
    metadata: { event: 'Kenema Music Festival' },
  },
});

if (payment.status === 'completed') {
  this.navigation.replace('ticket', { reference: 'order-1042' });
}
# Sends money to a bank account e.g. Sierra Leone Commercial Bank
curl https://api.monime.io/v1/payouts \
  -H "Authorization: Bearer $MONIME_ACCESS_TOKEN" \
  -H "Monime-Space-Id: $MONIME_SPACE_ID" \
  -H "Idempotency-Key: payout-1042" \
  -H "Content-Type: application/json" \
  -d '{
    "amount": { "currency": "SLE", "value": 25000 },
    "destination": {
      "type": "bank",
      "providerId": "slb001",
      "accountNumber": "003000000000001042"
    },
    "metadata": { "purpose": "Event vendor payment" }
  }'

Get started

Go from sign-up to your first API request in three steps.

  1. Create your accountSign up as a Monimeer and verify your details to reach the dashboard.
  2. Set up a SpaceCreate the business Space that owns your accounts, payments and API access.
  3. Get an access tokenGenerate a token and authenticate your first request in test mode.

What's new

The latest additions to Monime and these docs.

Explore by product

Accept money, move it between accounts and send it out, across every channel Monime supports.

Developer tools

Everything you need to integrate, test and ship.

Build in the open

Browse the source for Monime's open-source libraries, SDKs and platform plugins.
Visit GitHub