Daraja Agent Kit
Esc

    Loading search…

    Tutorials

    Learn Daraja from zero, in the sandbox.

    Each lesson is one idea, one thing to run, what to look for in the response, and a question to check you've got it. Sandbox money isn't real, so mistakes are free.

    0/27 lessons finished

    The roadmap

    Pick a path

    Choose a goal and the lessons you need light up below, in order.

    Six tracks, 27 lessons

    F

    Foundations

    4 lessons

    You can then make an authenticated call and explain the async model.

    0/4 finished

    1. F1What Daraja is
    2. F2Sandbox app and keys
    3. F3Tokens
    4. F4Accepted is not paid
    C

    Collecting money

    4 lessons

    You can then charge a phone and confirm the result.

    0/4 finished

    1. C1STK Push
    2. C2STK Query
    3. C3Paybill and Till (C2B)
    4. C4Dynamic QR
    K

    Callbacks

    3 lessons

    You can then receive and trust a result.

    0/3 finished

    1. K1What a callback is
    2. K2A local receiver with a tunnel
    3. K3Duplicates and idempotency
    P

    Paying out

    3 lessons

    You can then send money without paying twice.

    0/3 finished

    1. P1B2C
    2. P2Timeouts and unknown outcomes
    3. P3B2B
    O

    Operations

    3 lessons

    You can then find out what happened and undo it.

    0/3 finished

    1. O1Transaction Status
    2. O2Reversal
    3. O3Account Balance
    D

    Payment design

    4 lessons

    You can then design a system that never loses money.

    0/4 finished

    1. D1The state machine
    2. D2The ledger
    3. D3Reconciliation
    4. D4Going live
    G

    Build your own gateway

    6 lessons

    You can then write a small service that charges, stores every event and notifies your app.

    0/6 finished

    1. G1Token client
    2. G2Charge endpoint
    3. G3Callback receiver
    4. G4Status job
    5. G5Notify your app
    6. G6Review and harden

    Then build your own gateway

    Six steps, after Foundations and Callbacks: a small service you write yourself that charges, stores every event and notifies your app.

    Start the gateway track