BANK TRANSFER

Overview:
Bank Transfer (KEPSS) allows direct payouts to Keyan bank accounts.

Required Fields:

Field	Type	Requirement Level	Description
amount	number	Required	Amount in the local currency
currency	string	Required	TZS
method_code	string	Required	"BANK_TRANSFER_TZS"
recipient.wallet_uid	string	Required	Recipient’s bank account number
recipient.full_name	string	Required	Recipient’s bank account name
bank.code	string	Required	Bank code
reference	string	Required	Merchant reference
metadata	object	Optional	Merchant metadata
webhook_url	string	Optional	HTTPS URL for notifications
sender.full_name	string	Optional	Sender's full name
sender.address	string	Optional	Sender's address
sender.phone	string	Optional	Sender's phone number

Sample Payload:

JSON

{
  "amount": 100,
  "currency": "TZS",
  "method_code": "BANK_TRANSFER_TZS",
  "recipient": {
    "wallet_uid": "01712345678",
    "full_name": "Firstname Surname",
  },
  "bank": {
			"code": "90001",
  },
  "reference": "INV-2025-001",
  "metadata": {
    "internal_id": "user1234"
  },
  "webhook_url": "https://yourwebsite.com/webhook",
  "sender": {
    "full_name": "Firstname Surname",
    "address": "No 2, Green Median Str"
  }
}