Single Transfer

To call Do Transfer method of Quickteller service, you are required to generate Generate Token.

Do Transfer

This method is used to perform Quickteller Funds Transfer

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 recipent.
Step 2: Build the sender and beneficiary objects and initiate a Single Transfer call.
Step 3: Check transaction status

📘
Method
POST

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

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

Field	Field name	Data type	Max length	Required	Description
1	mac	string		true	a combination of customer data
2	transfercode	string		true	a uniques string to identify each transaction from sva perspective.
3	termination	object		true	This contains what the termination details. The content include amount and accountreceivable (also an object that has accountnumber and accounttype), entitycode, currencycode, paymentmethodcode and countrycode
a	amount	numeric		true	Amount that will be received by beneficiary in small denomination
b	accountreceivable	object		true
i	accountnumber	string	10	true	Account Number should be the 10 digits Nuban Account Number of the beneficiary.
ii.	accounttype	string	2	true	For bank accounts only. 10 = Savings account 20 = Current Account 00 = default value / not sure
c	entityCode	string	5	true	Code of bank/agent where transfer should be collected
d	currencyCode	string	3	true	ISO 4217 standard currency code
e	paymentMethodCode	string	2	true	One of the payment method codes for where the transfer is to be terminated. TerminatingPaymentMethodCode must always be AC.
f	countryCode	string	2	true	ISO 4217 standard currency code
4	sender	object		true	This contains the sender details. The content include phone, email, lastname, and othernames
a	Lastname	string	<50	true	Sender Last name
b	Othernames	string	<50true	true	Other names of Sender
c	Email	string		false	Email Address of Sender (Mandatory if customer should receive notification)
d	Phone	string		false	Phone Number of sender (Mandatory if customer should receive notification)
5	initiatingEntityCode	string		true	the terminalshort code is placed here
6	initiation	object		true	This contains the initiation details. The content include amount, currencycode, paymentmethodcode, channel, accounttype, and bankcode
a	amount	Numeric		true	Amount to be sent to the beneficiary in small denomination. Initiation Amount and Termination amount should be the same.
b	currencyCode	string	3	true	ISO 4217 standard currency code
c	paymentMethodCode	string	2	true	Payment Method Code of where transfer is being initiated from. InitiationPaymentMethodCodemust always be CA.
d	channel	Numeric		true	Channel must always be 7
e	accountType	string	2	false	For bank accounts only. 10 = Savings account 20 = Current Account 00 = default value / not sure
f	bankCode	string	3	false
7	beneficiary	object		true	This contains the beneficiary details. The content include lastname and othernames
a	lastname	string	<50	true
b	othernames	string	<50	true

📘
Endpoint
Url https://qa.interswitchng.com/quicktellerservice/api/v5/transactions/TransferFunds

📘
Headers
Authentication Bearer
TerminalID 3PBL0001

Sample Request

{
    "mac": "9f4e4f53c57be63e1f08d8f07a7bc1a9461e4a7d5304043daa1ef54bd727b6cde148f4fbfc5e2ad8c4a60f78dfa76304de671fbeb70657b1628f14b6b6baa5e1",
    "TransferCode": "990148469",
    "termination": {
        "amount": "100000",
        "accountReceivable": {
            "accountNumber": "0113711588",
            "accountType": "20"
        },
        "entityCode": "058",
        "currencyCode": "566",
        "paymentMethodCode": "AC",
        "countryCode": "NG"
    },
    "sender": {
        "phone": "08124888436",
        "email": "[email protected]",
        "lastname": "Adubiaro",
        "othernames": "Deborah"
    },
    "initiatingEntityCode": "voc",
    "initiation": {
        "amount": "100000",
        "currencyCode": "566",
        "paymentMethodCode": "CA",
        "channel": "7",
        "accountType": "00",
        "bankCode": "011"
    },
    "beneficiary": {
        "lastname": "ralph",
        "othernames": "ralpo"
    }
}

Response Message field description

Field	Field name	description
1	mac
2	transactiondate
3	transactionreference
4	pin
5	transfercode
6	responsecode
7	responsecodegrouping

Sample Response (success)

{
    "MAC": "0A009B68B5732E741255B034CC5BCD28A0F106E7E8C58D19FF1565362C92D5ECDBF2A9B590835D7E79D89EFC9B816B10CD7F4293E8BC05E1B5F2DA043C1779A5",
    "TransactionDate": "16/Nov/2020 08:48:10",
    "TransactionReference": "VOC|LOC|CA|FBN|AC|161120084810|KENVY7UBEK",
    "Pin": "c685c74ea2012394",
    "TransferCode": "9901484879",
    "ResponseCode": "90000",
    "ResponseCodeGrouping": "SUCCESSFUL"
}

Sample Response (failure)

{
    "ResponseCode": "30020",
    "ResponseDescription": "30020 - Duplicate TransferCode/Request reference: 990148469",
    "ResponseCodeGrouping": "PENDING"
}

Response Codes


30020	Duplicate Transaction Code
70075	No Customer Card
70076	Invalid Initiation Bank
20020	Null or Empty Payload