Morapay Developer Docs

These routes power hosted checkout and embed flows. They are unsigned unless noted. Base path: https://api.morapay.io/api/public. Use them from your checkout BFF or browser when building custom payer UI. Merchant-side configuration lives under Payment links and Business QR.

Payment links

Method	Path	Description
`GET`	`/links/:lookup`	Link by slug or public code
`POST`	`/links/:slug/sessions`	Start checkout session
`GET`	`/links/gas-checkout/:publicCode`	Gas-sponsored checkout payload

Legacy aliases under /payment-links/* mirror the same handlers.

Get payment link

GET /api/public/links/:lookup Optional query: wallet for wallet-aware pricing.

curl -s "https://api.morapay.io/api/public/links/invoice-42"

200 OK

{
  "success": true,
  "data": {
    "id": "link_uuid",
    "title": "Invoice #42",
    "amount": 100,
    "currency": "USD",
    "publicCode": "abc123xyz",
    "isActive": true
  }
}

404 Not Found

{
  "success": false,
  "error": "Payment link not found.",
  "code": "resource.not_found",
  "requestId": "req_pl404"
}

410 Gone

{
  "success": false,
  "error": "Payment link is no longer active.",
  "code": "resource.conflict",
  "requestId": "req_pl410"
}

Start checkout session

POST /api/public/links/:slug/sessions

curl -s -X POST "https://api.morapay.io/api/public/links/invoice-42/sessions" \
  -H "Content-Type: application/json" \
  -d '{ "amount": 100, "currency": "USD" }'

201 Created

{
  "success": true,
  "data": {
    "sessionId": "session_uuid",
    "transactionId": "txn_uuid",
    "status": "PENDING"
  }
}

422 Unprocessable Entity

{
  "success": false,
  "error": "Amount is below the minimum for this link.",
  "code": "links.amount.below_minimum",
  "requestId": "req_sess422"
}

Business pay

Method	Path	Description
`GET`	`/checkout/:businessSlug`	Open-amount business checkout config

curl -s "https://api.morapay.io/api/public/checkout/acme-coffee"

{
  "success": true,
  "data": {
    "businessSlug": "acme-coffee",
    "name": "Acme Coffee",
    "defaultCurrency": "GHS",
    "enabled": true
  }
}

See Business QR for merchant-side QR configuration.

Subscription checkout

Public subscription routes live under /api/public/subscription/*. Subscribers never use merchant API keys.

Method	Path	Description
`GET`	`/subscription/:planId`	Plan details for checkout
`POST`	`/subscription/:planId/quote`	Payer quote
`POST`	`/subscription/:planId/session`	Create checkout session
`GET`	`/subscription/session/:sessionId`	Session status
`POST`	`/subscription/:planId/subscribe`	Complete enrollment
`POST`	`/subscription/:planId/session/:sessionId/crypto/intent`	Crypto payment intent
`POST`	`/subscription/:planId/session/:sessionId/card/pay`	Card payment
`POST`	`/subscription/:planId/session/:sessionId/momo/charge`	MoMo charge
`GET`	`/subscription/:planId/session/:sessionId/momo/poll`	MoMo status poll

Merchant plan management: Subscriptions.

curl -s "https://api.morapay.io/api/public/subscription/plan_uuid"

200 OK

{
  "success": true,
  "data": {
    "id": "plan_uuid",
    "name": "Pro monthly",
    "amount": 29,
    "currency": "USD",
    "interval": "month"
  }
}

422 Unprocessable Entity

{
  "success": false,
  "error": "Plan is not active.",
  "code": "request.validation_failed",
  "requestId": "req_sub_checkout422"
}

Payment requests

Payer-facing helpers for REQUEST-type invoices created via Business QR.

Method	Path	Description
`GET`	`/requests/by-link/:linkId`	Lookup by pay link id
`GET`	`/requests/:id`	Request detail
`GET`	`/requests/calldata`	Crypto pay calldata
`POST`	`/requests/confirm-crypto`	Confirm on-chain payment

Merchant management uses signed GET/POST /api/v1/merchant/requests.

Checkout quotes

Method	Path	Description
`POST`	`/quotes/checkout`	Multi-row token quotes (checkout UI)
`POST`	`/quotes/swap`	Swap quote for on-chain checkout
`POST`	`/commerce/fiat`	Fiat payer total (Core: `/api/commerce/checkout-fiat`)

curl -s -X POST "https://api.morapay.io/api/public/quotes/checkout" \
  -H "Content-Type: application/json" \
  -d '{
    "inputAmount": "100",
    "inputCurrency": "USD",
    "environment": "LIVE"
  }'

See Quotes and Fiat checkout.

Transaction status

Method	Path	Description
`GET`	`/transactions/:id`	Transaction by id
`GET`	`/transactions/verify-by-hash`	Confirm on-chain payment
`GET`	`/fiat/transactions/verify/:reference`	Fiat payment status

Validation helpers

Method	Path	Description
`POST`	`/validate/momo`	Validate MoMo number
`POST`	`/validate/bank`	Validate bank account
`GET`	`/validate/banks?country=gha`	Bank list for checkout forms

Documented in Fiat checkout and Payout rails.

Getting started

Payments

Money movement

Account

Recurring and events

Public checkout

Catalog

Public checkout

Payment links

Get payment link

Start checkout session

Business pay

Subscription checkout

Payment requests

Checkout quotes

Transaction status

Validation helpers

​Payment links

​Get payment link

​Start checkout session

​Business pay

​Subscription checkout

​Payment requests

​Checkout quotes

​Transaction status

​Validation helpers

​Related

Payment links

Get payment link

Start checkout session

Business pay

Subscription checkout

Payment requests

Checkout quotes

Transaction status

Validation helpers

Related