Introduction

Start building for the invisible economy! We trust you must have gone through the How we work page for indepth understanding of the Peere Network

Welcome, Architect. This is the API for Peere Network. This documentation is your blueprint for building within the Peere ecosystem. We have structured this guide to transition you from foundational concepts to full implementation as smoothly as possible. Begin with environment, authentication and making your first API call. To start building immediately, create an account to receive your Sandbox keys. You can begin testing live endpoints in under a minute, with complete freedom to prototype the financial logic that will power your platform. Choose your integration based on your role and Let’s construct what comes next.

I'm a Merchant
I'm a Bank
I'm a Provider

Goal: Accept payments from customers using their identityWhat you’ll do:Find customers using email or device lookup, Send billing intents to establish payment agreements, Bill customers using approved agreement phrases, Handle webhook notifications for payment confirmationsKey endpoints:POST /v1/billing/intent - Request billing permission, POST /v1/customer/bill - Bill approved customers, GET /v1/customer/banks - Find customers by email

Goal: Enable your customers to pay using PeereWhat you’ll do:Migrate existing customers to Peere network, Link customer devices to their unique phrases, Handle merchant billing requests via webhooks, Manage customer payment decisions and limitsKey endpoints:POST /v1/bank/customers - Migrate customers, POST /v1/bank/customer/device/link - Link devices, POST /v1/billing/intent-response - Respond to billing intents

Goal: Help your merchants accept Peere paymentsWhat you’ll do:Onboard merchants to Peere network, Manage merchant trust levels and permissions, Handle billing operations on behalf of merchants, Process payments and manage settlementsKey endpoints:POST /v1/provider/merchants - Onboard merchants, PATCH /v1/provider/merchant/trust - Manage trust levels, POST /v1/merchant/customer/bill - Bill on behalf of merchants

Getting Started Checklist

Set Up Environment

Choose between live and sandbox environments and get your API credentials

Understand Authentication

Learn how to authenticate API requests using Bearer tokens

Configure Webhooks

Set up webhook endpoints to receive real-time notifications

Test Integration

Use sandbox environment to test your integration before going live

Go Live

Deploy to production and start processing real payments

Next Steps

Environment Setup

Configure your development and production environments

Authentication

Learn how to authenticate your API requests

Webhooks

Set up real-time notifications for your integration

API Reference

Explore detailed API documentation

Getting started

​Getting Started Checklist

​Next Steps

Environment Setup

Authentication

Webhooks

API Reference

Getting Started Checklist

Next Steps