Imt within Equity Bank

IMT Within Equity Bank

Test URL

POSThttps://uat.finserve.africa/v3-apis/transaction-api/v3.0/remittance/internalBankTransfer/imt

Live URL

POSThttps://api.finserve.africa/v3-apis/transaction-api/v3.0/remittance/internalBankTransfer/imt

Move Funds Within Equity Bank :bank: Across Kenya, Uganda, Tanzania, Rwanda & South Sudan.

200 Success Response Schema

Field Name	Field Type	Field Description
`status`	`string`	Response status
`code`	`number`	Response code
`message`	`string`	Response message
`data.transactionId`	`string`	unique transaction id
`data.status`	`string`	Transaction status

Example Request

⚠️

In the example below, please remember to replace the variables enclosed within curly brackets {{ }} with the actual values.

Signature Formula

source.accountNumber+transfer.amount+transfer.currencyCode+transfer.reference

Request Fields

Field Name	Field Type	Required	Description
`source.countryCode`	`string`	Yes	The country code of the source account.
`source.name`	`string`	Yes	The name of the source account holder.
`source.accountNumber`	`string`	Yes	The account number of the source account.
`sender.name`	`string`	Yes	The name of the sender.
`sender.documentType`	`string`	Yes	The type of document (e.g., NationalId).
`sender.documentNumber`	`string`	Yes	The document number of the sender.
`sender.countryCode`	`string`	Yes	The country code of the sender.
`sender.mobileNumber`	`string`	Yes	The mobile number of the sender.
`sender.email`	`string`	Yes	The email address of the sender.
`sender.address`	`string`	No	The address of the sender (optional).
`destination.type`	`string`	Yes	The type of destination (e.g., bank).
`destination.countryCode`	`string`	Yes	The country code of the destination account.
`destination.name`	`string`	Yes	The name of the destination account holder.
`destination.bankCode`	`string`	Yes	The bank code of the recipient's bank (if applicable).
`destination.accountNumber`	`string`	Yes	The account number of the recipient.
`destination.mobileNumber`	`string`	Yes	The mobile number of the recipient.
`destination.documentType`	`string`	Yes	The document type (e.g., NationalId) of the recipient.
`destination.documentNumber`	`string`	Yes	The document number of the recipient.
`destination.email`	`string`	No	The email address of the recipient (optional).
`destination.address`	`string`	No	The address of the recipient (optional).
`transfer.type`	`string`	Yes	The type of transfer (e.g., InternalFundsTransfer).
`transfer.amount`	`string`	Yes	The amount to be transferred.
`transfer.currencyCode`	`string`	Yes	The currency code (e.g., KES).
`transfer.reference`	`string`	Yes	The reference number for the transfer.
`transfer.date`	`string`	Yes	The date of the transfer.
`transfer.description`	`string`	No	A description of the transfer (optional).

Example Request

curl --request POST \
     --url https://uat.finserve.africa/v3-apis/transaction-api/v3.0/remittance/internalBankTransfer/imt \
     --header 'Authorization: Bearer {{token}}' \
     --header 'Content-Type: application/json' \
     --header 'signature: {{signature}}' \
     --data '
        {
            "source": {
                "countryCode": "KE",
                "name": "Merchant name",
                "accountNumber": "0011547896523"
            },
            "sender": {
                "name": "Sender Name",
                "documentType": "NationalId",
                "documentNumber": "12345",
                "countryCode": "KE",
                "mobileNumber": "0763000000",
                "email": "sender.name@example.com",
                "address": "UAE"
            },
            "destination": {
                "type": "bank",
                "countryCode": "KE",
                "name": "A N.Other",
                "bankCode": "03",
                "accountNumber": "101080530003",
                "mobileNumber": "0763123456",
                "documentType": "NationalId",
                "documentNumber": "123456",
                "email": "recipient.name@example.com",
                "address": "Nairobi"
            },
            "transfer": {
                "type": "InternalFundsTransfer",
                "amount": "1000",
                "currencyCode": "KES",
                "reference": "123456789012",
                "date": "2018-08-18",
                "description": "some remarks here"
            }
        }
    '

Example Response

{
    "status": true,
    "code": 0,
    "message": "success",
    "data": {
      "transactionId": "",
      "status": "SUCCESS"
    }
}

Intersubsidiary Bank Transfer Mobile Wallets