LogoLogo
  • Welcome!
  • Integrating Klasha
    • Getting Started
    • Prerequisites
    • Integration Checklist
    • Wrap Up
  • Overview
    • Introduction
    • Parameters
    • Token Generation
    • Errors
    • Countries & Payment Methods
  • Accepting Payments
    • Test Payments
    • Payments API
      • Mobile money
      • USSD
    • Payment Link
      • Dashboard
      • Payment Link API
    • Klasha Inline
    • HTML Checkout
  • PLUGINS AND SDKS
    • Plugins
    • Mobile SDKs
    • Web SDKs
  • MISC
    • Transaction Status
    • Webhook
    • API Status
  • Features
    • One-time Payments
    • Recurrent Payment
  • Transfers
    • Payout
      • ZAR Payout(new encryption)
      • KES Payout(new encryption)
      • ZMW Payout(new encryption)
      • TZS Payout(new encryption)
      • CNY Payout(new encryption)
    • Klasha Wire API
    • Swap API
    • Currency Coverage
  • Bank Account Collection
    • Virtual Account Creation
    • VA balance and statement
    • Business Identification Service
Powered by GitBook
On this page
  • Summary
  • Integration steps
  • Encryption algorithm here
  • Merchant Payout request
  • Make a POST call to the Merchant payout request API
  • Query payout status
  1. Transfers
  2. Payout

TZS Payout(new encryption)

PreviousZMW Payout(new encryption)NextCNY Payout(new encryption)

Last updated 1 month ago

Summary

These APIs are used to initiate a TZS payout

Before you begin!

  • Find your keys on the Klasha Dashboard → Settings → Generate API Keys ()

Integration steps

Merchant Payout request

Make a POST call to the Merchant payout request API

POST {{env_url}}/wallet/merchant/bank/transfer/request/v2

You would need to pass, as a header the x-auth-token. This can be obtained from your merchant dashboard → Settings → Generate API keys → Merchant public key.

Headers

Key
Value

Content-Type

application/json

x-auth-token

Your merchant public key

Authorization

Bearer <token here>

Request body (encrypted):

{ 
  "message": "encrypted-request-body"
}

Request body (plain)

Request Body

Name
Type
Description

country*

Country of payout - TZ

serviceCode*

Allowed Payout types:

Bank: TZ-BANK-B2C

Mobile Money: TZ-TIGO-B2C or TZ-Airtime-B2C

amount*

Amount - 1000

accountName*

Receiver's Name - John Doe

requestId*

String

Unique request's reference - TZS-payout-3

description*

String

Merchant's description - Payout

currency*

String

Currency of payout - TZS

accountNumber*

String

Receiver's account number - 255713998877

{
    "country": "TZ",
    "serviceCode": "TZ-TIGO-B2C",
    "amount": 1000,
    "accountName": "John Doe",
    "accountNumber": "255713998877",
    "currency": "TZS",
    "requestId": "TZS-payout-3",
    "description": "Payout",
}

{
    "id": 694,
    "amount": 1000.00,
    "payoutStatus": "PENDING",
    "requestId": "TZS-payout-3",
    "narration": "Payout",
    "country": "TZ",
    "fee": 826.00,
    "bankCode": "TZ-TIGO-B2C",
    "bankName": "TZ-TIGO-B2C",
    "accountNumber": "255713998877",
    "accountName": "John Doe"
}
{
    "message": "A human readable error message",
    "error": "Bad Request",
    "data": null
}

Query payout status

Make a to fetch status of initiated payouts.

here
Token Generation
call
Encryption algorithm here