BPP Guide

BPP (Beckn Provider Platform) Guide

Introduction

This guide provides a complete overview of setting up and integrating a Provider App Participant (BPP) with the UBI Network. A BPP represents applications (such as provider-facing apps, portals, or services) that publish benefits, receive applications, and manage approvals through the UBI ecosystem.

There could be two types of providers:

  1. Providers - who already have some portal or system of their own that publishes or lists benefits schemes

  2. And, Providers - who do not have any ready system

Benefit Schemes Schema Generalisation

The current Reference Provider Toaster Application makes use of the benefit scheme JSON schema defined here https://github.com/PSMRI/ubi-specs/blob/main/benefits-schema/v0.4/benefits-schema.json

Each Provider is supposed to map their Benefit-Scheme fields with this schema to have generalization across multiple providers on the network.

BPP Guide

The guide is divided into two key sections:

  • Protocol Server Setup for BPP

  • Connecting your Provider to BPP Protocol Server

Section 1:

Protocol Server Setup Guide

This Protocol Server Setup Guide is common for both types of providers.

Instructions to configure and register your BPP so it can connect to the UBI network. By following this guide, implementers will be able to:

  • Register their BPP on the UBI network.

Section 2:

For both types of providers stated above, they need to implement these functionalities:

  • Publish and expose benefits for discovery.

  • Provide application forms to and accept applications from seekers through the standard Init → Confirm flow.

  • Validate beneficiary eligibility and VCs using the Eligibility SDK and Verification SDK.

  • Manage application decisions (approve/reject) while ensuring compliance with open network protocols.

2.1 For Providers—who already have some portal or system of their own that publishes or lists benefits schemes

These types of providers will basically have to implement a layer between the UBI network and their existing provider backend services.

They can do so by following this BPP Integration Guide , which has step-by-step details of API flows (on_search, on_select, on_init, on_confirm) that the BPP must implement to respond to requests from Beneficiary Apps (BAPs) via the network.

Following this guide serves as the starting point for any organization or developer building a provider-facing application on the UBI network.

2.2 And, Providers - who do not have any ready system:

These types of providers without any ready system can potentially make use of Reference Provider Toaster Application.

All they need to do is follow the installation and configuration instructions and start using it to get an idea of how the provider app can be built.


Last updated