API Reference

Request for Transfer

POST /trans/v2/applyForTransfer

<Use this endpoint to request for small transfers (Mpesa Mobile Money Transfer / Airtel Mobile Money Transfer / Pesalink Transfer / Choice Internal Transfer)>

Parameters

Parameters	Type	Description	Is Required
payerAccountId	string	The ID of the account that is to make the transfer	TRUE
payeeBankCode	string	The bank code of the receiving bank Use /staticData/getBankCodes endpoint to get the list of bank codes	TRUE
payeeAccountId	string	The number of the receiving account	TRUE
payeeAccountName	string	The name of the receiving account This is mandatory when counterparty is a bank. When counterpaty is M-PESA/AIRTEL, it's optional.	FALSE
currency	string	Transfer currency	TRUE
amount	decimal	Transfer amount	TRUE
remark	string	The message to beneficiary. Not more than 100 characters.	FALSE
payeeMobileForNotification	string	Specify beneficiary's mobile number here and the bank will send SMS notification to inform him/her about the inbound.	FALSE

Response

00000

{
  "txId": ""
}

Query Transaction List

POST /query/getTransList

<Use this endpoint to query transaction list>

Parameters

Parameters	Type	Description	Is Required
userId	string	User ID in BaaS partner's system, a unique string to indentify a certain end user.	TRUE
accountId	string	End user's account number	TRUE
txType	array of string	Transaction type filter.	FALSE
txStatus	array of string	Transaction status filter.	FALSE
startTime	long	Start time	TRUE
endTime	long	End time	TRUE
pageNo	int	Page number	TRUE
pageSize	int	Page size	TRUE
orderByDesc	int	0 - ASC 1 - DESC (default)	FALSE

Response

00000

{
    "totalRows": "",
    "result": [
        {
            "txId": "",
            "txType": "",
            "accountId": "",
            "accountName": "",
            "accountType": "",
            "oppoAccountId": "",
            "oppoAccountName": "",
            "oppoBankName": "",
            "oppoBankCode": "",
            "thirdPartyTxType": "",
            "currency": "",
            "amount": "",
            "feeAmount": "",
            "txStatus": "",
            "createTime": "",
            "updateTime": "",
        }, {}      
    ]
}

Query Transaction Details

POST /query/getTransResult

<Use this endpoint to query the details of a transaction>

Parameters

Parameters	Type	Description	Is Required
txId	string	The ID of the transaction	TRUE

Response

00000

{
  "txId": "",
  "txType": "",
  "accountId": "",
  "accountName": "",
  "accountType": "",
  "oppoAccountId": "",
  "oppoAccountName": "",
  "oppoSubAccount": "",
  "mpesBusinessPayType": "",
  "oppoBankName": "",
  "oppoBankCode": "",
  "thirdPartyTxType": "",
  "currency": "",
  "amount": "",
  "feeAmount": "",
  "extInfo": {
    "transactionNarrative": "",
    "oppoPhoneNumber": "",
  },
  "externalTxId": "",
  "paymentChannel": "",
  "originalTxId": "",
  "refundTxId": "",
  "txStatus": "",
  "createTime": "",
  "updateTime": "",
  "errorCode": "",
  "errorMsg": "",
}