

<!DOCTYPE html>

<html lang="en_US">
<head>
  <meta charset="UTF-8">
  <meta http-equiv="X-UA-Compatible" content="IE=Edge">

  <link rel="stylesheet" href="/innbucks-merchant-api-integration/assets/css/just-the-docs-default.css">

  <link rel="stylesheet" href="/innbucks-merchant-api-integration/assets/css/just-the-docs-head-nav.css" id="jtd-head-nav-stylesheet">

  <style id="jtd-nav-activation">
  
    .site-nav ul li a {
      background-image: none;
    }

  </style>

  

  
    <script src="/innbucks-merchant-api-integration/assets/js/vendor/lunr.min.js"></script>
  

  <script src="/innbucks-merchant-api-integration/assets/js/just-the-docs.js"></script>

  <meta name="viewport" content="width=device-width, initial-scale=1">

  



  <!-- Begin Jekyll SEO tag v2.8.0 -->
<title>InnBucks Merchant API Developer Guide | Integrate the InnBucks Merchant API step by step: bearer-token login, payment codes with QR and deep link, code inquiry, agent deposits and reversals, with PHP/Laravel, Node.js and Python.</title>
<meta name="generator" content="Jekyll v3.10.0" />
<meta property="og:title" content="InnBucks Merchant API Developer Guide" />
<meta name="author" content="John Mugabe" />
<meta property="og:locale" content="en_US" />
<meta name="description" content="Integrate the InnBucks Merchant API step by step: bearer-token login, payment codes with QR and deep link, code inquiry, agent deposits and reversals, with PHP/Laravel, Node.js and Python." />
<meta property="og:description" content="Integrate the InnBucks Merchant API step by step: bearer-token login, payment codes with QR and deep link, code inquiry, agent deposits and reversals, with PHP/Laravel, Node.js and Python." />
<link rel="canonical" href="https://67even.github.io/innbucks-merchant-api-integration/assets/css/just-the-docs-head-nav.css" />
<meta property="og:url" content="https://67even.github.io/innbucks-merchant-api-integration/assets/css/just-the-docs-head-nav.css" />
<meta property="og:site_name" content="InnBucks Merchant API Developer Guide" />
<meta property="og:type" content="website" />
<meta name="twitter:card" content="summary" />
<meta property="twitter:title" content="InnBucks Merchant API Developer Guide" />
<script type="application/ld+json">
{"@context":"https://schema.org","@type":"WebPage","author":{"@type":"Person","name":"John Mugabe","url":"https://github.com/johnmugabe"},"description":"Integrate the InnBucks Merchant API step by step: bearer-token login, payment codes with QR and deep link, code inquiry, agent deposits and reversals, with PHP/Laravel, Node.js and Python.","headline":"InnBucks Merchant API Developer Guide","publisher":{"@type":"Organization","logo":{"@type":"ImageObject","url":"https://67even.github.io/innbucks-merchant-api-integration/assets/images/67even-logo.png"},"name":"John Mugabe"},"url":"https://67even.github.io/innbucks-merchant-api-integration/assets/css/just-the-docs-head-nav.css"}</script>
<!-- End Jekyll SEO tag -->


  <link rel="icon" type="image/png" href="/innbucks-merchant-api-integration/assets/images/favicon.png">
<link rel="apple-touch-icon" href="/innbucks-merchant-api-integration/assets/images/67even-logo.png">
<meta name="theme-color" content="#0c0e0b"><meta name="robots" content="index, follow, max-image-preview:large, max-snippet:-1, max-video-preview:-1">
<meta name="googlebot" content="index, follow, max-image-preview:large, max-snippet:-1">
<meta name="keywords" content="InnBucks API, InnBucks Merchant API, InnBucks integration, InnBucks payment code, InnBucks QR code, InnBucks deep link, InnBucks code inquiry, InnBucks agent API, InnBucks deposit API, InnBucks bank change, Zimbabwe mobile wallet API, Zimbabwe payment gateway, InnBucks Laravel, InnBucks PHP, InnBucks Node.js, InnBucks Python">
<meta name="author" content="John Mugabe">
<meta name="geo.region" content="ZW">

<meta property="og:image:type" content="image/png">
<meta name="twitter:label1" content="Written by">
<meta name="twitter:data1" content="John Mugabe">
<meta name="twitter:label2" content="Covers">
<meta name="twitter:data2" content="cURL, PHP/Laravel, Node.js, Python"><script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "BreadcrumbList",
  "itemListElement": [
    {
      "@type": "ListItem",
      "position": 1,
      "name": "InnBucks Merchant API Developer Guide",
      "item": "https://67even.github.io/innbucks-merchant-api-integration/"
    },
    {
      "@type": "ListItem",
      "position": 2,
      "name": null
    }
  ]
}
</script><script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "TechArticle",
  "headline": " - InnBucks Merchant API Developer Guide",
  "description": "",
  "image": "https://67even.github.io/innbucks-merchant-api-integration/assets/og/home.png",
  "datePublished": null,
  "dateModified": "2026-09-22T15:05:14+00:00",
  "inLanguage": "en",
  "mainEntityOfPage": {
    "@type": "WebPage",
    "@id": "https://67even.github.io/innbucks-merchant-api-integration/assets/css/just-the-docs-head-nav.css"
  },
  "author": {
    "@type": "Person",
    "name": "John Mugabe",
    "url": "https://github.com/johnmugabe"
  },
  "publisher": { "@id": "https://github.com/67even#organization" },
  "isPartOf": {
    "@type": "WebSite",
    "name": "InnBucks Merchant API Developer Guide",
    "url": "https://67even.github.io/innbucks-merchant-api-integration/"
  },
  "about": { "@type": "Thing", "name": "InnBucks Merchant API" },
  "proficiencyLevel": "Beginner",
  "dependencies": "InnBucks Merchant API test credentials (API key, username and password)"
}
</script>
<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "Organization",
  "@id": "https://github.com/67even#organization",
  "name": "67even",
  "url": "https://github.com/67even",
  "logo": {
    "@type": "ImageObject",
    "url": "https://67even.github.io/innbucks-merchant-api-integration/assets/images/67even-logo.png",
    "width": 512,
    "height": 575
  }
}
</script>


</head>

<body>
  <a class="skip-to-main" href="#main-content">Skip to main content</a>
  <svg xmlns="http://www.w3.org/2000/svg" class="d-none">
  <symbol id="svg-link" viewBox="0 0 24 24">
  <title>Link</title>
  <svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" class="feather feather-link">
    <path d="M10 13a5 5 0 0 0 7.54.54l3-3a5 5 0 0 0-7.07-7.07l-1.72 1.71"></path><path d="M14 11a5 5 0 0 0-7.54-.54l-3 3a5 5 0 0 0 7.07 7.07l1.71-1.71"></path>
  </svg>
</symbol>

  <symbol id="svg-menu" viewBox="0 0 24 24">
  <title>Menu</title>
  <svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" class="feather feather-menu">
    <line x1="3" y1="12" x2="21" y2="12"></line><line x1="3" y1="6" x2="21" y2="6"></line><line x1="3" y1="18" x2="21" y2="18"></line>
  </svg>
</symbol>

  <symbol id="svg-arrow-right" viewBox="0 0 24 24">
  <title>Expand</title>
  <svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" class="feather feather-chevron-right">
    <polyline points="9 18 15 12 9 6"></polyline>
  </svg>
</symbol>

  <!-- Feather. MIT License: https://github.com/feathericons/feather/blob/master/LICENSE -->
<symbol id="svg-external-link" width="24" height="24" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" class="feather feather-external-link">
  <title id="svg-external-link-title">(external link)</title>
  <path d="M18 13v6a2 2 0 0 1-2 2H5a2 2 0 0 1-2-2V8a2 2 0 0 1 2-2h6"></path><polyline points="15 3 21 3 21 9"></polyline><line x1="10" y1="14" x2="21" y2="3"></line>
</symbol>

  
    <symbol id="svg-doc" viewBox="0 0 24 24">
  <title>Document</title>
  <svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" class="feather feather-file">
    <path d="M13 2H6a2 2 0 0 0-2 2v16a2 2 0 0 0 2 2h12a2 2 0 0 0 2-2V9z"></path><polyline points="13 2 13 9 20 9"></polyline>
  </svg>
</symbol>

    <symbol id="svg-search" viewBox="0 0 24 24">
  <title>Search</title>
  <svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" class="feather feather-search">
    <circle cx="11" cy="11" r="8"></circle><line x1="21" y1="21" x2="16.65" y2="16.65"></line>
  </svg>
</symbol>

  
  
    <!-- Bootstrap Icons. MIT License: https://github.com/twbs/icons/blob/main/LICENSE.md -->
<symbol id="svg-copy" viewBox="0 0 16 16">
  <title>Copy</title>
  <svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" fill="currentColor" class="bi bi-clipboard" viewBox="0 0 16 16">
    <path d="M4 1.5H3a2 2 0 0 0-2 2V14a2 2 0 0 0 2 2h10a2 2 0 0 0 2-2V3.5a2 2 0 0 0-2-2h-1v1h1a1 1 0 0 1 1 1V14a1 1 0 0 1-1 1H3a1 1 0 0 1-1-1V3.5a1 1 0 0 1 1-1h1v-1z"/>
    <path d="M9.5 1a.5.5 0 0 1 .5.5v1a.5.5 0 0 1-.5.5h-3a.5.5 0 0 1-.5-.5v-1a.5.5 0 0 1 .5-.5h3zm-3-1A1.5 1.5 0 0 0 5 1.5v1A1.5 1.5 0 0 0 6.5 4h3A1.5 1.5 0 0 0 11 2.5v-1A1.5 1.5 0 0 0 9.5 0h-3z"/>
  </svg>
</symbol>
<symbol id="svg-copied" viewBox="0 0 16 16">
  <title>Copied</title>
  <svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" fill="currentColor" class="bi bi-clipboard-check-fill" viewBox="0 0 16 16">
    <path d="M6.5 0A1.5 1.5 0 0 0 5 1.5v1A1.5 1.5 0 0 0 6.5 4h3A1.5 1.5 0 0 0 11 2.5v-1A1.5 1.5 0 0 0 9.5 0h-3Zm3 1a.5.5 0 0 1 .5.5v1a.5.5 0 0 1-.5.5h-3a.5.5 0 0 1-.5-.5v-1a.5.5 0 0 1 .5-.5h3Z"/>
    <path d="M4 1.5H3a2 2 0 0 0-2 2V14a2 2 0 0 0 2 2h10a2 2 0 0 0 2-2V3.5a2 2 0 0 0-2-2h-1v1A2.5 2.5 0 0 1 9.5 5h-3A2.5 2.5 0 0 1 4 2.5v-1Zm6.854 7.354-3 3a.5.5 0 0 1-.708 0l-1.5-1.5a.5.5 0 0 1 .708-.708L7.5 10.793l2.646-2.647a.5.5 0 0 1 .708.708Z"/>
  </svg>
</symbol>

  
</svg>

  
    <header class="side-bar">
  <div class="site-header">
    <a href="/innbucks-merchant-api-integration/" class="site-title lh-tight">
  <div class="site-logo" role="img" aria-label="InnBucks Merchant API Developer Guide"></div>

</a>
    <button id="menu-button" class="site-button btn-reset" aria-label="Menu" aria-expanded="false">
      <svg viewBox="0 0 24 24" class="icon" aria-hidden="true"><use xlink:href="#svg-menu"></use></svg>
    </button>
  </div>

  <nav aria-label="Main" id="site-nav" class="site-nav">
  
  
    <ul class="nav-list"><li class="nav-list-item"><a href="/innbucks-merchant-api-integration/" class="nav-list-link">Home</a></li><li class="nav-list-item"><a href="/innbucks-merchant-api-integration/install/" class="nav-list-link">Installing the skill</a></li><li class="nav-list-item"><a href="/innbucks-merchant-api-integration/quick-start/" class="nav-list-link">Quick start</a></li><li class="nav-list-item"><a href="/innbucks-merchant-api-integration/getting-started/" class="nav-list-link">Prerequisites & onboarding</a></li><li class="nav-list-item"><a href="/innbucks-merchant-api-integration/authentication/" class="nav-list-link">Authentication</a></li><li class="nav-list-item"><a href="/innbucks-merchant-api-integration/payments/" class="nav-list-link">Accepting payments</a></li><li class="nav-list-item"><a href="/innbucks-merchant-api-integration/agent-services/" class="nav-list-link">Agent services</a></li><li class="nav-list-item"><a href="/innbucks-merchant-api-integration/api-reference/" class="nav-list-link">API reference</a></li><li class="nav-list-item"><a href="/innbucks-merchant-api-integration/errors/" class="nav-list-link">Response codes & errors</a></li><li class="nav-list-item"><a href="/innbucks-merchant-api-integration/code-examples/" class="nav-list-link">Code examples</a></li><li class="nav-list-item"><a href="/innbucks-merchant-api-integration/testing/" class="nav-list-link">Testing & UAT</a></li><li class="nav-list-item"><a href="/innbucks-merchant-api-integration/go-live/" class="nav-list-link">Going live</a></li><li class="nav-list-item"><a href="/innbucks-merchant-api-integration/best-practices/" class="nav-list-link">Best practices</a></li><li class="nav-list-item"><a href="/innbucks-merchant-api-integration/troubleshooting/" class="nav-list-link">Troubleshooting</a></li><li class="nav-list-item"><a href="/innbucks-merchant-api-integration/known-issues/" class="nav-list-link">Known documentation issues</a></li><li class="nav-list-item"><a href="/innbucks-merchant-api-integration/method-index/" class="nav-list-link">API method index</a></li><li class="nav-list-item"><a href="/innbucks-merchant-api-integration/about/" class="nav-list-link">About this guide</a></li></ul>
  <ul class="nav-list"><li class="nav-list-item external">
          <a href="https://github.com/67even/innbucks-merchant-api-integration" class="nav-list-link external"
            
          >
            Repository on GitHub
            <svg viewBox="0 0 24 24" aria-labelledby="svg-external-link-title"><use xlink:href="#svg-external-link"></use></svg>
          </a>
        </li></ul>
</nav>


<div class="d-md-block d-none site-footer">
  
  
    <a class="innbucks-mark" href="https://www.innbucks.co.zw" target="_blank" rel="noopener noreferrer">
  <img src="/innbucks-merchant-api-integration/assets/images/innbucks-logo-white.svg"
       alt="InnBucks" width="200" height="44">
</a>

  
  </div>
</header>

  
  <div class="main" id="top">
    <div id="main-header" class="main-header">
  
    

<div class="search" role="search">
  <div class="search-input-wrap">
    <input type="text" id="search-input" class="search-input" tabindex="0" placeholder="Search InnBucks Merchant API Developer Guide" autocomplete="off">
    <label for="search-input" class="search-label">
      <span class="sr-only">Search InnBucks Merchant API Developer Guide</span>
      <svg viewBox="0 0 24 24" class="search-icon" aria-hidden="true"><use xlink:href="#svg-search"></use></svg>
    </label>
  </div>
  <div id="search-results" class="search-results"></div>
</div>

  
  
  
    <nav aria-label="Auxiliary" class="aux-nav">
  <ul class="aux-nav-list">
    
      <li class="aux-nav-list-item">
        <a href="https://github.com/67even/innbucks-merchant-api-integration" class="site-button"
          
          target="_blank" rel="noopener noreferrer"
          
        >
          GitHub
        </a>
      </li>
    
  </ul>
</nav>

  
</div>

    <div class="main-content-wrap">
      
      <div id="main-content" class="main-content">
        <main>
          
            

          

          
            
          
        </main>
        
<hr>
<footer>
  
    <p><a href="#top" id="back-to-top">Back to top</a></p>
  

  <p class="text-small mb-0">MIT licensed. Written and maintained by <a href="https://github.com/johnmugabe">John Mugabe</a> under <a href="https://github.com/67even">67even</a>. Independent and community-maintained - not affiliated with or endorsed by InnBucks MicroBank Limited. "InnBucks" and the InnBucks logo belong to their owner.</p>

  <div class="d-md-none mt-4 fs-2">
    
    
      <a class="innbucks-mark" href="https://www.innbucks.co.zw" target="_blank" rel="noopener noreferrer">
  <img src="/innbucks-merchant-api-integration/assets/images/innbucks-logo-white.svg"
       alt="InnBucks" width="200" height="44">
</a>

    
  </div>
</footer>

      </div>
    </div>
    
      

<div class="search-overlay"></div>

    
  </div>

  
</body>
</html>

