

<!DOCTYPE html>

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

  <link rel="stylesheet" href="/ecocash-instant-payment-api/assets/css/just-the-docs-default.css">

  <link rel="stylesheet" href="/ecocash-instant-payment-api/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="/ecocash-instant-payment-api/assets/js/vendor/lunr.min.js"></script>
  

  <script src="/ecocash-instant-payment-api/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>EcoCash EIP Developer Guide | Integrate the EcoCash Instant Payment (EIP) API step by step: sandbox access, Basic auth, charge, lookup and refund, with PHP, Node.js, Python, Java and C#.</title>
<meta name="generator" content="Jekyll v3.10.0" />
<meta property="og:title" content="EcoCash EIP Developer Guide" />
<meta name="author" content="John Mugabe" />
<meta property="og:locale" content="en_US" />
<meta name="description" content="Integrate the EcoCash Instant Payment (EIP) API step by step: sandbox access, Basic auth, charge, lookup and refund, with PHP, Node.js, Python, Java and C#." />
<meta property="og:description" content="Integrate the EcoCash Instant Payment (EIP) API step by step: sandbox access, Basic auth, charge, lookup and refund, with PHP, Node.js, Python, Java and C#." />
<link rel="canonical" href="https://67even.github.io/ecocash-instant-payment-api/assets/css/just-the-docs-head-nav.css" />
<meta property="og:url" content="https://67even.github.io/ecocash-instant-payment-api/assets/css/just-the-docs-head-nav.css" />
<meta property="og:site_name" content="EcoCash EIP Developer Guide" />
<meta property="og:type" content="website" />
<meta name="twitter:card" content="summary" />
<meta property="twitter:title" content="EcoCash EIP 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 EcoCash Instant Payment (EIP) API step by step: sandbox access, Basic auth, charge, lookup and refund, with PHP, Node.js, Python, Java and C#.","headline":"EcoCash EIP Developer Guide","publisher":{"@type":"Organization","logo":{"@type":"ImageObject","url":"https://67even.github.io/ecocash-instant-payment-api/assets/images/67even-logo.png"},"name":"John Mugabe"},"url":"https://67even.github.io/ecocash-instant-payment-api/assets/css/just-the-docs-head-nav.css"}</script>
<!-- End Jekyll SEO tag -->


  <link rel="icon" type="image/png" href="/ecocash-instant-payment-api/assets/images/favicon.png">
<link rel="apple-touch-icon" href="/ecocash-instant-payment-api/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="EcoCash API, EcoCash Instant Payment, EcoCash EIP, EcoCash payment gateway, EcoCash sandbox, EcoCash developer portal, Zimbabwe mobile money API, USSD push payment, EcoCash refund API, EcoCash Laravel, EcoCash PHP, EcoCash Node.js, EcoCash Python, EcoCash Java, EcoCash C#">
<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, Java, C#"><script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "BreadcrumbList",
  "itemListElement": [
    {
      "@type": "ListItem",
      "position": 1,
      "name": "EcoCash EIP Developer Guide",
      "item": "https://67even.github.io/ecocash-instant-payment-api/"
    },
    {
      "@type": "ListItem",
      "position": 2,
      "name": null
    }
  ]
}
</script><script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "TechArticle",
  "headline": " - EcoCash EIP Developer Guide",
  "description": "",
  "image": "https://67even.github.io/ecocash-instant-payment-api/assets/og/home.png",
  "datePublished": null,
  "dateModified": "2026-09-22T05:50:24+00:00",
  "inLanguage": "en",
  "mainEntityOfPage": {
    "@type": "WebPage",
    "@id": "https://67even.github.io/ecocash-instant-payment-api/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": "EcoCash EIP Developer Guide",
    "url": "https://67even.github.io/ecocash-instant-payment-api/"
  },
  "about": { "@type": "Thing", "name": "EcoCash Instant Payment (EIP) API" },
  "proficiencyLevel": "Beginner",
  "dependencies": "EcoCash Developer Portal sandbox credentials (HTTP Basic auth)"
}
</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/ecocash-instant-payment-api/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="/ecocash-instant-payment-api/" class="site-title lh-tight">
  <div class="site-logo" role="img" aria-label="EcoCash EIP 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="/ecocash-instant-payment-api/" class="nav-list-link">Home</a></li><li class="nav-list-item"><a href="/ecocash-instant-payment-api/install/" class="nav-list-link">Installing the skill</a></li><li class="nav-list-item"><a href="/ecocash-instant-payment-api/getting-started/" class="nav-list-link">Get sandbox access</a></li><li class="nav-list-item"><a href="/ecocash-instant-payment-api/authentication/" class="nav-list-link">Authentication</a></li><li class="nav-list-item"><a href="/ecocash-instant-payment-api/first-payment/" class="nav-list-link">Your first payment</a></li><li class="nav-list-item"><a href="/ecocash-instant-payment-api/api-reference/" class="nav-list-link">API reference</a></li><li class="nav-list-item"><a href="/ecocash-instant-payment-api/errors/" class="nav-list-link">Statuses & errors</a></li><li class="nav-list-item"><a href="/ecocash-instant-payment-api/testing/" class="nav-list-link">Sandbox testing</a></li><li class="nav-list-item"><a href="/ecocash-instant-payment-api/sdks/" class="nav-list-link">SDKs & code examples</a></li><li class="nav-list-item"><a href="/ecocash-instant-payment-api/go-live/" class="nav-list-link">Going live</a></li><li class="nav-list-item"><a href="/ecocash-instant-payment-api/troubleshooting/" class="nav-list-link">Troubleshooting</a></li><li class="nav-list-item"><a href="/ecocash-instant-payment-api/known-issues/" class="nav-list-link">Known portal issues</a></li><li class="nav-list-item"><button class="nav-list-expander btn-reset" aria-label="Portal reference submenu" aria-expanded="false">
        <svg viewBox="0 0 24 24" aria-hidden="true"><use xlink:href="#svg-arrow-right"></use></svg>
      </button><a href="/ecocash-instant-payment-api/reference/" class="nav-list-link">Portal reference</a><ul class="nav-list"><li class="nav-list-item"><a href="/ecocash-instant-payment-api/reference/documentation-tab/" class="nav-list-link">Documentation tab (verbatim)</a></li><li class="nav-list-item"><a href="/ecocash-instant-payment-api/reference/sdks-tab/" class="nav-list-link">SDKs & Codegen tab (verbatim)</a></li><li class="nav-list-item"><a href="/ecocash-instant-payment-api/reference/portal-getting-started/" class="nav-list-link">Portal walkthrough</a></li></ul></li><li class="nav-list-item"><a href="/ecocash-instant-payment-api/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/ecocash-instant-payment-api" 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="ecocash-mark" href="https://developers.ecocash.co.zw/portal" target="_blank" rel="noopener noreferrer">
  <img src="/ecocash-instant-payment-api/assets/images/ecocash-logo.svg"
       alt="EcoCash developer portal" width="200" height="41">
</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 EcoCash EIP Developer Guide" autocomplete="off">
    <label for="search-input" class="search-label">
      <span class="sr-only">Search EcoCash EIP 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/ecocash-instant-payment-api" 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 EcoCash Holdings Zimbabwe. "EcoCash" and the EcoCash logo belong to their owner.</p>

  <div class="d-md-none mt-4 fs-2">
    
    
      <a class="ecocash-mark" href="https://developers.ecocash.co.zw/portal" target="_blank" rel="noopener noreferrer">
  <img src="/ecocash-instant-payment-api/assets/images/ecocash-logo.svg"
       alt="EcoCash developer portal" width="200" height="41">
</a>

    
  </div>
</footer>

      </div>
    </div>
    
      

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

    
  </div>

  
</body>
</html>

