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

Tag	Data Type	Required	Description
source.name	String	Yes	Source account Name
source.countryCode	String	Yes	source accountCountry Code e.g. UGA
source.accountNumber	String	Yes	source account number
source.currencyCode	String	Yes	source account currency code e.g UGX
destination.type	String	Yes	destination type e.g bank
destination.countryCode	String	Yes	destination account country code e.g. KE
destination.name	String	Yes	destination name
destination.accountNumber	String	Yes	destination account number
transfer.type	String	Yes	transfer type ( SubsidiaryBankTransfer)
transfer.amount	String	Yes	transfer amount
transfer.currencyCode	String	Yes	transfer currency code e.g. UGX
transfer.reference	String	Yes	unique reference number (min 12 characters, max 20 characters)
transfer.amount	Float	Yes	transfer amount
transfer.date	Date	Yes	transaction date
transfer.description	String	Yes	transaction 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

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

Response Codes

Http Response Code	Response Code	Description
200	0	Request Processed Successfully
400	900100	Invalid Signature
401	401, 401101	Unauthorized access
403	403	Forbidden
500	500	Internal Server Error

Pesalink - Mobile Within Equity Bank