Single Transfer

Request Parameters

Below is a list of parameters for the request

Fields

Required

Length

Format

Description

initiatingEntityCode

Yes

<=5

Alphanumeric

Client Entity Code issued by Interswitch

transferCode

Yes

<=12

Numeric

Unique Transfer code generated on Client’s system and sent in DoTransfer request. 4 digit transfer code prefix will be provided by Interswitch.

Sender

lastname

Yes

<=50

Alphanumeric

Sender Last name

othernames

Yes

<=50

Alphanumeric

Other names of sender

email

No

<=50

Alphanumeric

Email Address of sender
(Required if the customer should receive notification)

phone

No

<=25

Alphanumeric

Phone number of sender (Mandatory if customer should receive notification)

Beneficiary

lastname

Yes

<=50

Alphanumeric

Last name of the beneficiary.

othernames

Yes

<=50

Alphanumeric

Other names of the beneficiary

email

No

<=50

Alphanumeric

Email address of the beneficiary (required if the beneficiary should receive notification)

phone

No

<=25

Alphanumeric

Phone number of the beneficiary (Required if customer should receive notification).

initiationAmount

Yes

Numeric

Amount to be sent to the beneficiary in small denomination. Initiation Amount and Termination amount should be the same.

initiationChannel

Yes

Numeric

Channel must always be 7

initiationPaymentMethodCode

Yes

2

Alphanumeric

Payment Method Code of where transfer is being initiated from.
InitiationPaymentMethodCodemust always be CA.

initiationCurrencyCode

Yes

3

Alphanumeric

ISO 4217 standard currency code

terminatingPaymentMethodCode

Yes

2

Alphanumeric

One of the payment method codes for where the transfer is to be terminated.
TerminatingPaymentMethodCode must always be AC.

terminatingAmount

Yes

Numeric

Amount that will be received by beneficiary in small denomination

terminatingCurrencyCode

Yes

3

Alphanumeric

ISO 4217 standard currency code

terminatingCountryCode

Yes

2

Alphanumeric

ISO 4217 standard currency code

terminatingAccountNumber

Yes

<=50

Alphanumeric

Account number/Card number of beneficiary. Account Number should be the 10 digits Nuban Account Number of the beneficiary.

terminatingAccountType

Yes

2

Alphanumeric

For bank accounts only.
10 = Savings account

20 = Current Account

00 = default value / not sure

terminatingEntityCode

Yes

<=5

Alphanumeric

Code of bank/agent where transfer should be collected

terminatingEntityLocationCode

No

<=5

Alphanumeric

Code of bank/agent location where transfer should be collected, For cash receivable transfers only.

terminatingStateCode

No

<=5

Alphanumeric

State where the transfer can be collected, For cash receivable transfers only.

cashReceivableTypeCode

No

2

Alphanumeric

For cash receivable transfers only.

identificationTypeCode

No

2

Alphanumeric

For cash receivable transfers only.

mac

Yes

Message authentication code, for message integrity. Should be computed with SHA512 algorithm of the string in Request MAC fields below

Language
Click Try It! to start a request and see the response here!