API ReferenceDeveloper ConsoleDeveloper Community

Single Transfer

Suggest Edits

This endpoint enables transfer of funds between one account or wallet to another, i.e. single or peer to peer transactions. it enables users with the capability to send money from one person to another.

Process Flow

Step 1: Ideally, the first step will be to validate the account number of the intended recipient.
Step 2: Build the sender and beneficiary objects and initiate a Single Transfer call.
Step 3: Check transaction status

📘

List of Bank Codes

You can make an API call to view a list of exhaustive bank codes here

Request Message description
N/B: Secure data version 12 was used

📘

mac

mac = sha512(initiatingAmount + initiatingCurrencyCode + initiatingPaymentMethodCode + terminatingAmount + terminatingCurrencyCode + terminatingPaymentMethodCode + terminatingCountryCode)

Sample Requests

curl --location 'https://qa.interswitchng.com/quicktellerservice/api/v5/transactions/DoAccountNameInquiry' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer {{Access Token}}' \
--header 'TerminalId: 3PBL0001' \
--header 'bankCode: 044'\
--header 'accountId: 0730804844'
--X GET

curl 'https://qa.interswitchng.com/quicktellerservice/api/v5/transactions/TransferFunds' \
--header 'Authentication: Bearer Token'
--header 'terminalId: 3PBL' \
--header 'Content-Type: application/json' \
--data-raw '{
			"transferCode":"030009998999",
			  "mac": "9f4e4f53c57be63e1f08d8f07a7bc1a9461e4a7d5304043daa1ef54bd727b6cde148f4fbfc5e2ad8c4a60f78dfa76304de671fbeb70657b1628f14b6b6baa5e1",
			  "termination": {
				"amount": "100000",
				"accountReceivable": {
				  "accountNumber": "3001155245",
				  "accountType": "00"
				},
				"entityCode": "044",
				"currencyCode": "566",
				"paymentMethodCode": "AC",
				"countryCode": "NG"
			  },
			  "sender": {
				"phone": "08124888436",
				"email": "[email protected]",
				"lastname": "Adubiaro",
				"othernames": "Deborah"
			  },
			  "initiatingEntityCode": "PBL",
			  
			  "initiation": {
				"amount": "100000",
				"currencyCode": "566",
				"paymentMethodCode": "CA",
				"channel": "7"
			  },
				"beneficiary": {
				"lastname": "ralph",
				"othernames": "ralpo"
			  }
              
			}'

Sample Responses

{
    "AccountName": "VICTOR ADEKUNLE ODEBODE",
    "ResponseCode": "90000",
    "ResponseCodeGrouping": "SUCCESSFUL"
}

{
  "MAC":"9f4e4f53c57be63e1f08d8f07a7bc1a9461e4a7d5304043daa1ef54bd727b6cde148f4fbfc5e2ad8c4a60f78dfa76304de671fbeb70657b1628f14b6b6baa5e1",
  "TransactionDate": "03/Feb/2023 03:47:064",
  "TransactionReference": "PBL|LOC|CA|ABP|AC|030223154706|U4AN48D7",
  "Pin": null,
  "TransferCode": null,
  "ResponseCode": "90000",
  "ResponseCodeGrouping": "SUCCESSFUL"
}

Updated 13 days ago