Normie.tech Documentation

Version 1.0

1. Overview

What is Normie.tech?

Normie.tech is a payment infrastructure platform that enables Web3 businesses to accept traditional card payments (Visa/Mastercard) from users and automatically settle transactions in crypto (e.g., stablecoins). It bridges the gap between fiat and crypto payments, simplifying onboarding for non-crypto-native users.

Why Normie.tech?

• Problem:
  • Users face friction with crypto onboarding (KYC, wallet setup, gas fees).
  • Web3 businesses lose customers who prefer card payments and there is no way to onboard 4B+ card users.
• Solution:
  • Normie.tech accept card payments from your customers and auto-convert them to instant stablecoin settlements for you, no crypto complexity for your customers.

For Whom?

• Web3 Businesses: NFT platforms, DAOs, DeFi apps, crypto subscriptions, etc.
• Users: Anyone who wants to interact with Web3 without holding crypto or managing wallets.

2. Codebase Structure

• The repository is organized as:

Key Directories:

• infra/: SST infrastructure-as-code (API routes, secrets, event buses).
• packages/core/: Shared business logic and type definitions.
• packages/functions/: Serverless functions for payment/webhook handling.
• packages/scripts/: Deployment scripts and precompiled project configurations.
• packages/www/: Next.js frontend .

3. How to Integrate

1. Request an API Access

• Schedule a Call.
• Provide necassary metadata such as project Id, contract addresses(if required) and other project specified details.
• Get an Normie API.

2. Initialize an Normie Client

Example:

import createClient from "openapi-fetch";

export const normieTechClient =  createClient<paths>({ 
  baseUrl: "https://api.normie.tech",
  headers:{
    "Access-Control-Allow-Origin":"*",
    "Content-Type":"application/json"
  }
});

set Normie API in .env

NORMIE_TECH_API_KEY = ""

3. Sending API Requests to your project

• POST Request for Order Checkout

     const res = (
       await normieTechClient.POST(`/v1/${your_project_id}/0/checkout`,
       {
           params: {
             header: {
               "x-api-key":process.env.NORMIE_TECH_API_KEY ?? "",
               "Access-Control-Allow-Origin":"*"
             } as any
           },
           body:{
             customId,
             amount,
             chainId,
             customerEmail,
             name,
             blockChainName,
             success_url,
             extraMetadata:{
               // provide extra metadata as per requirement
             },
             metadata:{
               // provide necessary data (payoutAddress) 
             }
           }
         }))
  

• GET Request for transaction details

      async function getTransactionData(transactionId: string) {
      const transactionData = (
        await normieTechClient.GET('/v1/{projectId}/transactions/{transactionId}',{
          params:{
              header:{
                  "x-api-key":process.env.NORMIE_TECH_API_KEY ?? "",
                  
              },
              path:{
                  projectId:"your_project_id",
                  transactionId:transactionId
              }
  
          }
      }))
      return transactionData
  }
  

4.DOCS

[https://api.normie.tech/v1/{your_project_id}/docs]