Machine-readable manifests

{
  "version": "2026-05-19",
  "description": "Plain-English purpose of this file.",
  ...
}

{
  "name": "Kenya",
  "countryCode": "KE",
  "currency": "KES",
  "collections": [
    {
      "method": "mobile_money",
      "minAmount": 5,
      "maxAmount": 250000,
      "operators": ["mpesa", "airtel"],
      "operatorIdRequired": false,
      "requiredFields": ["amount", "currency", "externalReference", "phoneNumber"]
    },
    {
      "method": "bank_transfer",
      "minAmount": 50,
      "maxAmount": 999999,
      "requiredFields": ["amount", "currency", "externalReference", "email"]
    }
  ],
  "payouts": [
    { "destination": "MoMo",         "minAmount": 10, "maxAmount": 250000, "operators": ["mpesa", "airtel"] },
    { "destination": "Bank Account", "minAmount": 10, "maxAmount": 999999, "requiresBankCode": true },
    { "destination": "Paybill",      "minAmount": 10, "maxAmount": 250000 },
    { "destination": "Till",         "minAmount": 10, "maxAmount": 250000 }
  ]
}

{
  "errorCode": "DUPLICATE_EXTERNAL_REFERENCE",
  "httpStatus": 409,
  "retryable": false,
  "developerAction": "Use a new externalReference. The supplied value has already been used for a different transaction."
}

rules:
  - id: finality
    severity: critical
    summary: Wait for status: successful before releasing value.
  - id: external-reference
    severity: critical
    summary: Unique externalReference on every money movement request.
  ...

curl https://docs.honeycoin.app/manifests/coverage.json | jq '.countries[] | select(.countryCode == "KE")'

import httpx

coverage = httpx.get("https://docs.honeycoin.app/manifests/coverage.json").json()
errors   = httpx.get("https://docs.honeycoin.app/manifests/errors.json").json()

def supports(country_code: str, method: str) -> bool:
    for c in coverage["countries"]:
        if c["countryCode"] == country_code:
            return any(m["method"] == method for m in c["collections"])
    return False

def is_retryable(error_code: str) -> bool:
    # errorCode-keyed entries live under apiErrors; transactionErrors are
    # matched by messagePattern/category and webhookErrors by description.
    return any(e["errorCode"] == error_code and e["retryable"] for e in errors["apiErrors"])

const coverage = await fetch("https://docs.honeycoin.app/manifests/coverage.json").then(r => r.json());
const errors   = await fetch("https://docs.honeycoin.app/manifests/errors.json").then(r => r.json());

const supports = (countryCode, method) =>
  coverage.countries
    .find(c => c.countryCode === countryCode)
    ?.collections.some(m => m.method === method)
  ?? false;