Beckn Protocol Flow

Interactive visualization of the 10 Beckn API actions and how they flow through the network

Protocol Flow Diagram

BAPBuyer AppGATEWAYMulticast (search only)BPPProvider PlatformREGISTRYsearchmulticaston_search / on_select / on_init / on_confirm / ...select, init, confirm, status, track, cancel, update, rating, support (direct BAP to BPP)

10 Beckn Actions

Discovery
Order
Fulfillment
Post-Fulfillment

/search

/on_search

Discover products/services across the network. The only action that goes through the Gateway for multicast discovery.

Sender
BAP
Receiver
BPP
Gateway
Yes
Category
discovery
{
  "context": {
    "domain": "retail",
    "action": "search",
    "country": "IDN",
    "city": "std:021",
    "bap_id": "buyer-app.example.com",
    "bap_uri": "https://buyer-app.example.com/beckn",
    "transaction_id": "txn_abc123",
    "message_id": "msg_001",
    "timestamp": "2026-04-05T10:00:00Z"
  },
  "message": {
    "intent": {
      "item": {
        "descriptor": {
          "name": "indomie"
        }
      },
      "fulfillment": {
        "type": "Delivery"
      }
    }
  }
}

Indonesia Payment Mapping

How Indonesian payment methods map to Beckn payment types

ON-ORDER
QRIS, GoPay, OVO, DANA

Payment collected at order time

PRE-FULFILLMENT
Virtual Account (BCA/BNI/BRI)

Payment before fulfillment begins

ON-FULFILLMENT
Cash on Delivery (COD)

Payment at time of delivery

POST-FULFILLMENT
Credit / Pay Later (Kredivo)

Payment after service completion