Skip to content

Commit f48d43b

Browse files
committed
docs: layer2 configuration and payment
docs: added recommendations section in RFC 001 and 002 docs: created RFC000 for Terminology docs: modified last updated file time
1 parent 85a9281 commit f48d43b

3 files changed

Lines changed: 261 additions & 99 deletions

File tree

docs/BECKN-000-Terminology.md

Lines changed: 98 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,98 @@
1+
# BECKN-000: Terminology
2+
3+
## License:
4+
This document is licensed under a [Creative Commons Attribution-NonCommercial-ShareAlike 4.0 International License](https://creativecommons.org/licenses/by-nc-sa/4.0/).
5+
6+
![Creative Commons License](https://licensebuttons.net/l/by-nc-sa/4.0/88x31.png)
7+
8+
## Category:
9+
Terminology
10+
11+
## Published on:
12+
Sept 9th, 2025
13+
14+
## Last Updated on:
15+
Sept 16th, 2025
16+
17+
## History:
18+
Click on this [link](https://github.com/beckn/protocol-specifications/commits/core-1.2-release/docs/BECKN-000-Terminology.md) to view the history of changes to this document
19+
20+
## Issues:
21+
To view issues related to this document, click on this [link](https://github.com/beckn/protocol-specifications/issues?q=is%3Aissue+label%3ABECKN-000)
22+
23+
## Discussions:
24+
To view discussions related to this document, click on this [link](https://github.com/beckn/protocol-specifications/discussions?discussions_q=label%3ABECKN-000)
25+
26+
## Authors:
27+
1. [Ravi Prakash](https://github.com/ravi-prakash-v)
28+
29+
## Reviewers:
30+
1. [Sujith Nair](https://github.com/sjthnrk)
31+
2. [Pramod Varma](https://github.com/pramodkvarma)
32+
3. [Venkatraman Mahadevan](https://github.com/venkatramanm)
33+
34+
# Abstract
35+
36+
This document provides a comprehensive glossary of terms and definitions used across the Beckn Protocol specifications. It serves as a reference for network participants, implementers, and stakeholders to ensure consistent understanding of key concepts and terminology.
37+
38+
# Scope
39+
40+
This document defines the standard terminology used across all Beckn Protocol specifications and related documents. It is intended for:
41+
42+
1. Network participants implementing Beckn Protocol
43+
2. Developers building on Beckn-enabled networks
44+
3. Policy makers and governance bodies
45+
4. Technical writers and documentation maintainers
46+
47+
## Prerequisites
48+
49+
Readers of this document should have:
50+
51+
1. Basic understanding of distributed systems and API protocols
52+
2. Familiarity with commerce and transaction terminology
53+
3. Knowledge of the Beckn Protocol architecture
54+
55+
# Introduction
56+
57+
The Beckn Protocol ecosystem involves multiple stakeholders, technical concepts, and domain-specific terminology. This document establishes a common vocabulary to ensure clear communication and consistent implementation across all Beckn-enabled networks.
58+
59+
# Terminology
60+
61+
1. **Network :** In the context of beckn protocol, a network refers to an open commerce network formed by the instantiation of beckn protocol specification with a standard network policy
62+
2. **Network Participant:** Any platform that has implemented beckn protocol specification and is part of an open commerce network
63+
3. **Schema:** These are JSON Schema objects with properties as defined in the core specification
64+
4. **Action:** These are specific events that occur during the lifecycle of a typical commerce transaction
65+
5. **Network Policy**: These are specific rules that apply to the implementers of a network while developing the protocol API middleware
66+
6. **BAP (Beckn Application Platform)**: A platform that enables buyers to discover and transact with sellers on a Beckn-enabled network
67+
7. **BPP (Beckn Provider Platform)**: A platform that enables sellers to list their services and fulfill orders on a Beckn-enabled network
68+
8. **BG (Beckn Gateway)**: A network infrastructure component used for provider discovery; it routes discovery requests from BAPs to relevant BPPs and enforces basic routing and validation policies
69+
9. **Registry**: A centralized directory service that maintains information about network participants, their capabilities, and network policies
70+
71+
# Examples
72+
73+
## Common Usage Examples
74+
75+
- **Network**: "The mobility network in Bangalore uses Beckn Protocol with specific policies for ride-sharing and public transport"
76+
- **Network Participant**: "Uber and Ola are both network participants in the mobility network"
77+
- **Schema**: "The Order schema defines the structure for transaction data"
78+
- **Action**: "The search action initiates the discovery of available services"
79+
- **Network Policy**: "The network policy requires all transactions to include location data"
80+
- **BAP**: "The Swiggy app acts as a BAP, allowing users to discover and order food from restaurants"
81+
- **BPP**: "Restaurant partners use a BPP platform to list their menus and manage orders"
82+
- **BG**: "The beckn gateway is used for provider discovery and routes search requests from BAPs to relevant BPPs in the food delivery network"
83+
- **Registry**: "The registry maintains a directory of all food delivery BPPs and their service capabilities"
84+
85+
# Recommendations
86+
87+
- Use terminology consistently across all documentation and implementations
88+
- Refer to this document when introducing new terms or concepts
89+
- Update this document when new terminology is introduced in the protocol
90+
- Cross-reference related terms to maintain clarity
91+
92+
# Acknowledgements
93+
94+
The authors would like to thank the following people for their support and contributions to this document.
95+
96+
* Pramod Varma (Beckn Foundation)
97+
* Sujith Nair (Beckn Foundation)
98+
* Venkataramanan Mahadevan (Humbhionline)

0 commit comments

Comments
 (0)