{"info":{"_postman_id":"a2c45c85-9d4c-4c73-bd4f-351f510abbe5","name":"Treasury (Lango sandbox)","description":"Generated from the Treasury API group. Run \"Get a token\" first — every other request reads {{token}}.","schema":"https://schema.getpostman.com/json/collection/v2.1.0/collection.json"},"item":[{"name":"Get a token","request":{"method":"POST","header":[{"key":"Content-Type","value":"application/x-www-form-urlencoded"}],"url":{"raw":"{{baseUrl}}/oauth/v1/token","host":["{{baseUrl}}"],"path":["oauth","v1","token"]},"auth":{"type":"basic","basic":[{"key":"username","value":"{{consumerKey}}","type":"string"},{"key":"password","value":"{{consumerSecret}}","type":"string"}]},"body":{"mode":"urlencoded","urlencoded":[{"key":"grant_type","value":"client_credentials","type":"text"}]}},"event":[{"listen":"test","script":{"type":"text/javascript","exec":["const data = pm.response.json();","pm.collectionVariables.set('token', data.access_token);"]}}]},{"name":"Payouts","item":[{"name":"Send a payout","request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"}],"url":{"raw":"{{baseUrl}}/payouts/v1/send","host":["{{baseUrl}}"],"path":["payouts","v1","send"],"variable":[],"query":[]},"description":"Moves money out of your float. Each `reference` can be used once.","body":{"mode":"raw","raw":"{\n  \"amount\": 25000,\n  \"currency\": \"KES\",\n  \"destination\": {\n    \"type\": \"mobile\",\n    \"phoneNumber\": \"254712345678\"\n  },\n  \"reference\": \"PAYRUN-0917-044\",\n  \"reason\": \"Salary\",\n  \"callbackUrl\": \"https://example.com/hooks/lango\"\n}","options":{"raw":{"language":"json"}}}},"response":[{"name":"Payout succeeds","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"}],"url":{"raw":"{{baseUrl}}/payouts/v1/send","host":["{{baseUrl}}"],"path":["payouts","v1","send"],"variable":[],"query":[]},"description":"Moves money out of your float. Each `reference` can be used once.","body":{"mode":"raw","raw":"{\n  \"amount\": 25000,\n  \"currency\": \"KES\",\n  \"destination\": {\n    \"type\": \"mobile\",\n    \"phoneNumber\": \"254712345678\"\n  },\n  \"reference\": \"PAYRUN-0917-044\",\n  \"reason\": \"Salary\",\n  \"callbackUrl\": \"https://example.com/hooks/lango\"\n}","options":{"raw":{"language":"json"}}}},"status":"Accepted","code":202,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"body":"{\n  \"payoutId\": \"pay_b494fpq8\",\n  \"status\": \"QUEUED\"\n}"},{"name":"Float too low","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"}],"url":{"raw":"{{baseUrl}}/payouts/v1/send","host":["{{baseUrl}}"],"path":["payouts","v1","send"],"variable":[],"query":[]},"description":"Moves money out of your float. Each `reference` can be used once.","body":{"mode":"raw","raw":"{\n  \"amount\": 25000,\n  \"currency\": \"KES\",\n  \"destination\": {\n    \"type\": \"mobile\",\n    \"phoneNumber\": \"254712345678\"\n  },\n  \"reference\": \"PAYRUN-0917-044\",\n  \"reason\": \"Salary\",\n  \"callbackUrl\": \"https://example.com/hooks/lango\"\n}","options":{"raw":{"language":"json"}}}},"status":"Accepted","code":202,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"body":"{\n  \"payoutId\": \"pay_3zsp12jn\",\n  \"status\": \"QUEUED\"\n}"},{"name":"Duplicate reference","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"}],"url":{"raw":"{{baseUrl}}/payouts/v1/send","host":["{{baseUrl}}"],"path":["payouts","v1","send"],"variable":[],"query":[]},"description":"Moves money out of your float. Each `reference` can be used once.","body":{"mode":"raw","raw":"{\n  \"amount\": 25000,\n  \"currency\": \"KES\",\n  \"destination\": {\n    \"type\": \"mobile\",\n    \"phoneNumber\": \"254712345678\"\n  },\n  \"reference\": \"PAYRUN-0917-044\",\n  \"reason\": \"Salary\",\n  \"callbackUrl\": \"https://example.com/hooks/lango\"\n}","options":{"raw":{"language":"json"}}}},"status":"Conflict","code":409,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"body":"{\n  \"error\": \"DUPLICATE_REFERENCE\",\n  \"message\": \"A payout with this reference already exists.\",\n  \"requestId\": \"req_aqfy3xg4\"\n}"}]},{"name":"Check a payout","request":{"method":"GET","header":[],"url":{"raw":"{{baseUrl}}/payouts/v1/:payoutId","host":["{{baseUrl}}"],"path":["payouts","v1",":payoutId"],"variable":[{"key":"payoutId","value":"pay_3n7c2q8d"}],"query":[]},"description":"Check a payout"},"response":[{"name":"Delivered","originalRequest":{"method":"GET","header":[],"url":{"raw":"{{baseUrl}}/payouts/v1/:payoutId","host":["{{baseUrl}}"],"path":["payouts","v1",":payoutId"],"variable":[{"key":"payoutId","value":"pay_3n7c2q8d"}],"query":[]},"description":"Check a payout"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"body":"{\n  \"payoutId\": \"pay_3n7c2q8d\",\n  \"status\": \"DELIVERED\",\n  \"amount\": 25000,\n  \"receipt\": \"RCT_c035a8p9\"\n}"}]}]},{"name":"Ledger","item":[{"name":"Look up a transaction","request":{"method":"GET","header":[],"url":{"raw":"{{baseUrl}}/ledger/v2/transactions/:transactionId","host":["{{baseUrl}}"],"path":["ledger","v2","transactions",":transactionId"],"variable":[{"key":"transactionId","value":"RCT_5h1v9k2b"}],"query":[]},"description":"Look up a transaction"},"response":[{"name":"Found","originalRequest":{"method":"GET","header":[],"url":{"raw":"{{baseUrl}}/ledger/v2/transactions/:transactionId","host":["{{baseUrl}}"],"path":["ledger","v2","transactions",":transactionId"],"variable":[{"key":"transactionId","value":"RCT_5h1v9k2b"}],"query":[]},"description":"Look up a transaction"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"body":"{\n  \"transactionId\": \"RCT_5h1v9k2b\",\n  \"type\": \"COLLECTION\",\n  \"status\": \"COMPLETED\",\n  \"amount\": 1500,\n  \"currency\": \"KES\",\n  \"counterparty\": \"254712345678\",\n  \"reference\": \"INV-2041\",\n  \"completedAt\": \"2026-09-28T10:59:32.769Z\"\n}"},{"name":"Unknown receipt","originalRequest":{"method":"GET","header":[],"url":{"raw":"{{baseUrl}}/ledger/v2/transactions/:transactionId","host":["{{baseUrl}}"],"path":["ledger","v2","transactions",":transactionId"],"variable":[{"key":"transactionId","value":"RCT_5h1v9k2b"}],"query":[]},"description":"Look up a transaction"},"status":"Not Found","code":404,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"body":"{\n  \"error\": \"NOT_FOUND\",\n  \"message\": \"No transaction with that receipt number.\",\n  \"requestId\": \"req_a8n3r880\"\n}"}]},{"name":"Reverse a transaction","request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"}],"url":{"raw":"{{baseUrl}}/ledger/v2/transactions/:transactionId/reversal","host":["{{baseUrl}}"],"path":["ledger","v2","transactions",":transactionId","reversal"],"variable":[{"key":"transactionId","value":"RCT_5h1v9k2b"}],"query":[]},"description":"Returns the money to the payer. Only completed collections can be reversed, once.","body":{"mode":"raw","raw":"{\n  \"reason\": \"Customer paid twice\",\n  \"callbackUrl\": \"https://example.com/hooks/lango\"\n}","options":{"raw":{"language":"json"}}}},"response":[{"name":"Reversal succeeds","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"}],"url":{"raw":"{{baseUrl}}/ledger/v2/transactions/:transactionId/reversal","host":["{{baseUrl}}"],"path":["ledger","v2","transactions",":transactionId","reversal"],"variable":[{"key":"transactionId","value":"RCT_5h1v9k2b"}],"query":[]},"description":"Returns the money to the payer. Only completed collections can be reversed, once.","body":{"mode":"raw","raw":"{\n  \"reason\": \"Customer paid twice\",\n  \"callbackUrl\": \"https://example.com/hooks/lango\"\n}","options":{"raw":{"language":"json"}}}},"status":"Accepted","code":202,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"body":"{\n  \"reversalId\": \"rev_m4vq5jzx\",\n  \"status\": \"QUEUED\"\n}"}]},{"name":"Read your balances","request":{"method":"GET","header":[],"url":{"raw":"{{baseUrl}}/ledger/v2/balance?shortCode=600100","host":["{{baseUrl}}"],"path":["ledger","v2","balance"],"variable":[],"query":[{"key":"shortCode","value":"600100"}]},"description":"Read your balances"},"response":[{"name":"Healthy float","originalRequest":{"method":"GET","header":[],"url":{"raw":"{{baseUrl}}/ledger/v2/balance?shortCode=600100","host":["{{baseUrl}}"],"path":["ledger","v2","balance"],"variable":[],"query":[{"key":"shortCode","value":"600100"}]},"description":"Read your balances"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"body":"{\n  \"shortCode\": \"600100\",\n  \"currency\": \"KES\",\n  \"available\": 1284500,\n  \"reserved\": 25000,\n  \"asOf\": \"2026-09-28T10:59:32.769Z\"\n}"}]}]}],"auth":{"type":"bearer","bearer":[{"key":"token","value":"{{token}}","type":"string"}]},"variable":[{"key":"baseUrl","value":"https://devportal.softwaregroup.com/api/sandbox","type":"string"},{"key":"consumerKey","value":"","type":"string"},{"key":"consumerSecret","value":"","type":"string"},{"key":"token","value":"","type":"string"}]}