Guides & Tutorials
Jenga API
Send Money
Intersubsidiary Bank Transfer

Inter Subsidiary Bank Transfer

Description This API is used to transfer money to another Equity bank account in another Subsidiary(another country where Equity bank is operating).

Test URL

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

Live URL

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

Request parameters

TagData TypeRequiredDescription
source.nameStringYesSource account Name
source.countryCodeStringYessource accountCountry Code e.g. UGA
source.accountNumberStringYessource account number
source.currencyCodeStringYessource account currency code e.g UGX
destination.typeStringYesdestination type e.g bank
destination.countryCodeStringYesdestination account country code e.g. KE
destination.nameStringYesdestination name
destination.accountNumberStringYesdestination account number
transfer.typeStringYestransfer type ( SubsidiaryBankTransfer)
transfer.amountStringYestransfer amount
transfer.currencyCodeStringYestransfer currency code e.g. UGX
transfer.referenceStringYesunique reference number (min 12 characters, max 20 characters)
transfer.amountFloatYestransfer amount
transfer.dateDateYestransaction date
transfer.descriptionStringYestransaction description

Example Request

Signature Formulae e.g. 00013XXXX6836500.00KES192112602006
source.accountNumber+transfer.amount+transfer.currencyCode+transfer.reference
Example Request
curl -X POST \
	-d '{
    "source": {
        "name": "Jane Doe",
        "countryCode": "UGA",
        "accountNumber": "1036200681230",
        "currencyCode": "UGX"
    },
    "destination": {
        "type": "bank",
        "countryCode": "KE",
        "name": "John Doe",
        "accountNumber": "0020100014605"
    },
    "transfer": {
        "type": "SubsidiaryBankTransfer",
        "amount": "5002",
        "currencyCode": "UGX",
        "reference": "202312190820",
        "date": "2023-07-07",
        "description": "Test ISFT"
    }
}'  \
	-H 'Authorization: Bearer {{access_token}}'  \
	-H 'Content-Type: application/json'  \
	-H 'signature: {{signature}}'  \
	-L 'https://uat.finserve.africa/v3-apis/transaction-api/v3.0/remittance/subsidiary'

Example Response

Example Response
{
    "status": true,
    "code": 0,
    "message": "success",
    "reference": "202307071525",
    "data": {
        "transactionId": "S8985371",
        "status": "SUCCESS"
    }
}

Response Codes

Http Response CodeResponse CodeDescription
2000Request Processed Successfully
400900100Invalid Signature
401401, 401101Unauthorized access
403403Forbidden
500500Internal Server Error