Request Parameters<\/h1>\n

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Fields<\/strong><\/td>\n	M\/O<\/strong><\/td>\n	Length<\/strong><\/td>\n	Format<\/strong><\/td>\n	Description<\/strong><\/td>\n<\/tr>\n
Initiating Entity Code<\/td>\n	M<\/td>\n	<=5<\/td>\n	Alphanumeric<\/td>\n	Client Entity Code issued by Interswitch<\/td>\n<\/tr>\n
TransferCode<\/td>\n	M<\/td>\n	<=12<\/td>\n	Numeric<\/td>\n	Unique Transfer code generated on Client’s system and sent in DoTransfer request. 4 digit transfer code prefix will be provided by Interswitch.<\/td>\n<\/tr>\n
Sender<\/strong><\/td>\n	<\/td>\n	<\/td>\n	<\/td>\n	<\/td>\n<\/tr>\n
Lastname<\/td>\n	M<\/td>\n	<=50<\/td>\n	Alphanumeric<\/td>\n	Sender Last name<\/td>\n<\/tr>\n
Othernames<\/td>\n	M<\/td>\n	<=50<\/td>\n	Alphanumeric<\/td>\n	Other names of Sender<\/td>\n<\/tr>\n
Email<\/td>\n	O<\/td>\n	<=50<\/td>\n	Alphanumeric<\/td>\n	Email Address of Sender (Mandatory if customer should receive notification)<\/td>\n<\/tr>\n
Phone<\/td>\n	O<\/td>\n	<=25<\/td>\n	Alphanumeric<\/td>\n	Phone Number of sender (Mandatory if customer should receive notification)<\/td>\n<\/tr>\n
<\/td>\n	<\/td>\n	<\/td>\n	<\/td>\n	<\/td>\n<\/tr>\n
Beneficiary<\/strong><\/td>\n	<\/td>\n	<\/td>\n	<\/td>\n	<\/td>\n<\/tr>\n
Lastname<\/td>\n	M<\/td>\n	<=50<\/td>\n	Alphanumeric<\/td>\n	Sender Last name<\/td>\n<\/tr>\n
Othernames<\/td>\n	M<\/td>\n	<=50<\/td>\n	Alphanumeric<\/td>\n	Other names of Sender<\/td>\n<\/tr>\n
Email<\/td>\n	O<\/td>\n	<=50<\/td>\n	Alphanumeric<\/td>\n	Email Address of Sender (Mandatory if customer should receive notification)<\/td>\n<\/tr>\n
Phone<\/td>\n	O<\/td>\n	<=25<\/td>\n	Alphanumeric<\/td>\n	Phone Number of sender (Mandatory if customer should receive notification)<\/td>\n<\/tr>\n
<\/td>\n	<\/td>\n	<\/td>\n	<\/td>\n	<\/td>\n<\/tr>\n
Initiation Amount<\/td>\n	M<\/td>\n	<\/td>\n	Numeric<\/td>\n	Amount to be sent to the beneficiary in small denomination. Initiation Amount and Termination amount should be the same.<\/td>\n<\/tr>\n
<\/td>\n	<\/td>\n	<\/td>\n	<\/td>\n	<\/td>\n<\/tr>\n
Initiation Channel<\/td>\n	M<\/td>\n	<\/td>\n	Numeric<\/td>\n	See Payment channel in Appendix<\/a>. <\/p>\n Channel must always be 7<\/strong>.<\/p>\n<\/td>\n<\/tr>\n
<\/td>\n	<\/td>\n	<\/td>\n	<\/td>\n	<\/td>\n<\/tr>\n
InitiationPaymentMethodCode<\/td>\n	M<\/td>\n	2<\/td>\n	Alphanumeric<\/td>\n	Payment Method Code of where transfer is being initiated from. <\/p>\n InitiationPaymentMethodCodemust always be CA<\/strong>.<\/p>\n<\/td>\n<\/tr>\n
<\/td>\n	<\/td>\n	<\/td>\n	<\/td>\n	<\/td>\n<\/tr>\n
InitiationCurrencyCode<\/td>\n	M<\/td>\n	3<\/td>\n	Alphanumeric<\/td>\n	ISO 4217 standard currency code<\/td>\n<\/tr>\n
<\/td>\n	<\/td>\n	<\/td>\n	<\/td>\n	<\/td>\n<\/tr>\n
TerminatingPaymentMethodCode<\/td>\n	M<\/td>\n	2<\/td>\n	Alphanumeric<\/td>\n	One of the payment method codes for where the transfer is to be terminated. <\/p>\n TerminatingPaymentMethodCode must always be AC<\/strong>.<\/p>\n<\/td>\n<\/tr>\n
<\/td>\n	<\/td>\n	<\/td>\n	<\/td>\n	<\/td>\n<\/tr>\n
TerminatingAmount<\/td>\n	M<\/td>\n	<\/td>\n	Numeric<\/td>\n	Amount that will be received by beneficiary in small denomination<\/td>\n<\/tr>\n
<\/td>\n	<\/td>\n	<\/td>\n	<\/td>\n	<\/td>\n<\/tr>\n
TerminatingCurrencyCode<\/td>\n	M<\/td>\n	3<\/td>\n	Alphanumeric<\/td>\n	ISO 4217 standard currency code<\/td>\n<\/tr>\n
<\/td>\n	<\/td>\n	<\/td>\n	<\/td>\n	<\/td>\n<\/tr>\n
TerminatingCountryCode<\/td>\n	M<\/td>\n	2<\/td>\n	Alphanumeric<\/td>\n	ISO 4217 standard currency code<\/td>\n<\/tr>\n
<\/td>\n	<\/td>\n	<\/td>\n	<\/td>\n	<\/td>\n<\/tr>\n
TerminatingAccountNumber<\/td>\n	M<\/td>\n	<=50<\/td>\n	Alphanumeric<\/td>\n	Account number\/Card number of beneficiary. Account Number should be the 10 digits Nuban Account Number of the beneficiary.<\/td>\n<\/tr>\n
<\/td>\n	<\/td>\n	<\/td>\n	<\/td>\n	<\/td>\n<\/tr>\n
<\/td>\n	<\/td>\n	<\/td>\n	<\/td>\n	<\/td>\n<\/tr>\n
TerminatingAccountType<\/td>\n	M<\/td>\n	2<\/td>\n	Alphanumeric<\/td>\n	For bank accounts only. <\/p>\n 10 = Savings account<\/p>\n 20 = Current Account<\/p>\n 00 = default value \/ not sure<\/p>\n<\/td>\n<\/tr>\n
<\/td>\n	<\/td>\n	<\/td>\n	<\/td>\n	<\/td>\n<\/tr>\n
TerminatingEntityCode<\/td>\n	M<\/td>\n	<=5<\/td>\n	alphanumeric<\/td>\n	Code of bank\/agent where transfer should be collected<\/td>\n<\/tr>\n
<\/td>\n	<\/td>\n	<\/td>\n	<\/td>\n	<\/td>\n<\/tr>\n
TerminatingEntityLocationCode<\/td>\n	O<\/td>\n	<=5<\/td>\n	Alphanumeric<\/td>\n	Code of bank\/agent location where transfer should be collected, For cash receivable transfers only.<\/td>\n<\/tr>\n
TerminatingStateCode<\/td>\n	O<\/td>\n	<=5<\/td>\n	Alphanumeric<\/td>\n	State where the transfer can be collected, For cash receivable transfers only.<\/td>\n<\/tr>\n
<\/td>\n	<\/td>\n	<\/td>\n	<\/td>\n	<\/td>\n<\/tr>\n
CashReceivableTypeCode<\/td>\n	O<\/td>\n	2<\/td>\n	Alphanumeric<\/td>\n	For cash receivable transfers only.<\/td>\n<\/tr>\n
<\/td>\n	<\/td>\n	<\/td>\n	<\/td>\n	<\/td>\n<\/tr>\n
<\/td>\n	<\/td>\n	<\/td>\n	<\/td>\n	<\/td>\n<\/tr>\n
IdentificationTypeCode <\/span><\/td>\n	O<\/td>\n	2<\/td>\n	Alphanumeric<\/td>\n	For cash receivable transfers only.<\/td>\n<\/tr>\n
<\/td>\n	<\/td>\n	<\/td>\n	<\/td>\n	<\/td>\n<\/tr>\n
<\/td>\n	<\/td>\n	<\/td>\n	<\/td>\n	<\/td>\n<\/tr>\n
MAC<\/td>\n	M<\/td>\n	<\/td>\n	<\/td>\n	Message authentication code, for message integrity. Should be computed with SHA512 algorithm of the string in Request MAC fields below<\/td>\n<\/tr>\n
<\/td>\n	<\/td>\n	<\/td>\n	<\/td>\n	<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<\/div>\n  <\/h1>\n Request MAC Computation<\/h1>\n MAC should be computed with SHA512 algorithm of the string below:<\/p>\n macCipher = InitiatingAmount <\/strong>+ <\/strong>InitiatingCurrencyCode + <\/strong>InitiatingPaymentMethodCode + <\/strong>TerminatingAmount + <\/strong>TerminatingCurrencyCode + <\/strong>TerminatingPaymentMethodCode + <\/strong>TerminatingCountryCode<\/strong><\/p>\n MAC = SHA512(macCipher)<\/p>\n Funds Transfer Request<\/h1>\n \n Sample Request<\/b><\/div>\n \n \n {<\/div>\n   “mac”: “9f4e4f53c57be63e1f08d8f07a7bc1a9461e4a7d5304043daa1ef54bd727b6cde148f4fbfc5e2ad8c4a60f78dfa76304de671fbeb70657b1628f14b6b6baa5e1”,<\/div>\n   “beneficiary”: {<\/div>\n     “lastname”: “Test”,<\/div>\n     “othernames”: “Transfer”<\/div>\n   },<\/div>\n   “initiatingEntityCode”: “DMO”,<\/div>\n   “initiation”: {<\/div>\n     “amount”: “100000”,<\/div>\n     “channel”: “7”,<\/div>\n     “currencyCode”: “566”,<\/div>\n     “paymentMethodCode”: “CA”<\/div>\n   },<\/div>\n   “sender”: {<\/div>\n     “email”: “testtransfer@test.com”,<\/div>\n     “lastname”: “Testing”,<\/div>\n     “othernames”: “Test”,<\/div>\n     “phone”: “0732246413”<\/div>\n   },<\/div>\n   “termination”: {<\/div>\n     “accountReceivable”: {<\/div>\n       “accountNumber”: “0014261063”,<\/div>\n       “accountType”: “10”<\/div>\n     },<\/div>\n     “amount”: “100000”,<\/div>\n     “countryCode”: “NG”,<\/div>\n     “currencyCode”: “566”,<\/div>\n     “entityCode”: “058”,<\/div>\n     “paymentMethodCode”: “AC”<\/div>\n   },<\/div>\n   “transferCode”: “145334232423423”<\/div>\n }<\/div>\n<\/div>\n<\/div>\n<\/div>\n  <\/h2>\n Funds Transfer Response<\/h1>\n A HTTP response code 200 is sent back for a success Response Parameters<\/p>\n \n\n\n\n\n\n\n\n Field<\/strong><\/td>\n Description<\/strong><\/td>\n  <\/td>\n<\/tr>\n ResponseCode<\/td>\n Response Code<\/td>\n  <\/td>\n<\/tr>\n MAC<\/td>\n Response MAC<\/td>\n  <\/td>\n<\/tr>\n TransactionReference<\/td>\n Unique Transaction reference generated by Interswitch<\/td>\n  <\/td>\n<\/tr>\n TransactionDate <\/p>\n ResponseCodeGrouping<\/p>\n<\/td>\n Date and Time of Transaction <\/p>\n A response of status is returned (SUCCESS, FAILED, or PENDING)<\/p>\n<\/td>\n  <\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<\/div>\n Response MAC Fields<\/h1>\n ResponseCodeTransactionReferenceTransferCode HTTP 200<\/p>\n \n Sample Response<\/b><\/div>\n \n {\n \"ResponseCode\": 90000,\n \"ResponseCodeGrouping\": \"SUCCESSFUL\",\n \"TransactionReference\": \"UYU|LOC|CA|UBA|AC|180876100046|JNCYUPYN\",\n \"Pin\": \"\",\n \"TransferCode\": 182890812522,\n \"MAC\": \"F87BC044A5TYHG5BD9AC41CA005065D7391CB3F173F85B4POI8FF7A79DC5A37BE105C1BD8653B850FD68BA803D976AA8E91F0A6285398UYT279847F60D58F4C0\",\n \"TransactionDate\": \"18\/Sep\/2018 10:00:46\"\n}<\/pre>\n<\/div>\n<\/div>\n\n\n <\/p>\n\n\n\n NOTE: <\/strong>Kindly ensure the QueryTransaction request is made no earlier than 360secs after DoTransfer response has been received or the timeout period has elapsed. Also, ensure your request timeout is set to a minimum of 60secs for DoTransfer calls<\/em>.<\/font><\/p>\n","protected":false},"author":169,"featured_media":0,"parent":804,"menu_order":9,"comment_status":"closed","ping_status":"closed","template":"","meta":{"spay_email":""},"doc_tag":[],"_links":{"self":[{"href":"https:\/\/sandbox.interswitchng.com\/docbase\/wp-json\/wp\/v2\/docs\/813"}],"collection":[{"href":"https:\/\/sandbox.interswitchng.com\/docbase\/wp-json\/wp\/v2\/docs"}],"about":[{"href":"https:\/\/sandbox.interswitchng.com\/docbase\/wp-json\/wp\/v2\/types\/docs"}],"author":[{"embeddable":true,"href":"https:\/\/sandbox.interswitchng.com\/docbase\/wp-json\/wp\/v2\/users\/169"}],"replies":[{"embeddable":true,"href":"https:\/\/sandbox.interswitchng.com\/docbase\/wp-json\/wp\/v2\/comments?post=813"}],"version-history":[{"count":25,"href":"https:\/\/sandbox.interswitchng.com\/docbase\/wp-json\/wp\/v2\/docs\/813\/revisions"}],"predecessor-version":[{"id":3834,"href":"https:\/\/sandbox.interswitchng.com\/docbase\/wp-json\/wp\/v2\/docs\/813\/revisions\/3834"}],"up":[{"embeddable":true,"href":"https:\/\/sandbox.interswitchng.com\/docbase\/wp-json\/wp\/v2\/docs\/804"}],"next":[{"title":"Query Transaction","link":"https:\/\/sandbox.interswitchng.com\/docbase\/docs\/quickteller-sva\/query-transaction\/","href":"https:\/\/sandbox.interswitchng.com\/docbase\/wp-json\/wp\/v2\/docs\/814"}],"prev":[{"title":"Name Enquiry","link":"https:\/\/sandbox.interswitchng.com\/docbase\/docs\/quickteller-sva\/name-enquiry\/","href":"https:\/\/sandbox.interswitchng.com\/docbase\/wp-json\/wp\/v2\/docs\/3080"}],"wp:attachment":[{"href":"https:\/\/sandbox.interswitchng.com\/docbase\/wp-json\/wp\/v2\/media?parent=813"}],"wp:term":[{"taxonomy":"doc_tag","embeddable":true,"href":"https:\/\/sandbox.interswitchng.com\/docbase\/wp-json\/wp\/v2\/doc_tag?post=813"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}