Afriref - Africa reference data

Payment pricing

x402 payment terms are the authoritative price for calling this endpoint.

Payment option 1

0.05 USDC
Atomic price: 50000 · Network: eip155:8453 · Asset: USDC · Scheme: exact

[
  {
    "scheme": "exact",
    "network": "eip155:8453",
    "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
    "amount": "50000",
    "payTo": "0x1F0409ccD20A2fb497d4DeCeF4E17e9d0688FeA6"
  }
]

Observed health

Status

Reachable

Latest latency

1254 ms

Average latency

1156 ms

HTTP status

403

Last checked

2026-11-02T06:17:28.549Z

Reachability

100% over 14 checks

Latency is measured to the first response headers. A reachable result does not verify response accuracy or merchant identity.

Input schema

{
  "additionalProperties": false,
  "properties": {
    "body": {
      "properties": {
        "annual_rent": {
          "description": "Nigeria: annual rent paid (unlocks rent relief, capped ₦500,000)",
          "type": "number"
        },
        "basic": {
          "description": "Nigeria: basic pay (for exact pension/NHF base; else a 40/30/10 split is assumed and disclosed)",
          "type": "number"
        },
        "country": {
          "description": "ISO country code (payroll supported: Nigeria, Kenya)",
          "enum": [
            "ke",
            "ng"
          ],
          "type": "string"
        },
        "gross": {
          "description": "Gross pay in local currency",
          "type": "number"
        },
        "housing": {
          "description": "Nigeria: housing allowance",
          "type": "number"
        },
        "insurance_premium": {
          "description": "Kenya: insurance premium (15% relief, capped KES 5,000/mo)",
          "type": "number"
        },
        "nhis_premium": {
          "description": "Nigeria: NHIS employee premium if a scheme deducts one",
          "type": "number"
        },
        "pensionable_pay": {
          "description": "Kenya: pensionable pay for NSSF tiers (default = gross capped at UEL)",
          "type": "number"
        },
        "period": {
          "description": "Period the gross covers (default month)",
          "enum": [
            "month",
            "year"
          ],
          "type": "string"
        },
        "receipt": {
          "description": "Optional. true adds an Ed25519 answer receipt on a paid 200, included in this price. Not a certified extract.",
          "type": "boolean"
        },
        "sector": {
          "description": "Nigeria: public applies NHF 2.5%; private (default) sets NHF 0",
          "enum": [
            "public",
            "private"
          ],
          "type": "string"
        },
        "transport": {
          "description": "Nigeria: transport allowance",
          "type": "number"
        }
      },
      "required": [
        "country",
        "gross"
      ],
      "type": "object"
    },
    "bodyType": {
      "enum": [
        "json",
        "form-data",
        "text"
      ],
      "type": "string"
    },
    "method": {
      "enum": [
        "POST"
      ],
      "type": "string"
    },
    "type": {
      "const": "http",
      "type": "string"
    }
  },
  "required": [
    "type",
    "method",
    "bodyType",
    "body"
  ],
  "type": "object"
}

Output schema

{
  "properties": {
    "example": {
      "properties": {
        "assumptions": {
          "description": "Disclosed assumptions (e.g. Nigeria 40/30/10 pay split, sector default)",
          "type": "array"
        },
        "gross_pay": {
          "type": "number"
        },
        "income_tax": {
          "description": "PAYE payable",
          "type": "number"
        },
        "net_pay": {
          "description": "Net take-home pay",
          "type": "number"
        },
        "provenance": {
          "description": "Bracket instrument + contribution-law citations",
          "type": "object"
        },
        "receipt": {
          "description": "Only when receipt=true on a paid 200. kind answer_receipt. Verify at /certified/public-key.",
          "type": "object"
        },
        "scope_note": {
          "type": "string"
        },
        "status": {
          "type": "string"
        },
        "statutory_deductions": {
          "description": "Employee social-security contributions withheld",
          "type": "object"
        },
        "tax_breakdown": {
          "description": "Per-bracket workings",
          "type": "array"
        },
        "taxable_income": {
          "type": "number"
        }
      },
      "required": [
        "status",
        "net_pay",
        "income_tax",
        "statutory_deductions"
      ],
      "type": "object"
    },
    "type": {
      "type": "string"
    }
  },
  "required": [
    "type"
  ],
  "type": "object"
}