post https://sandbox.interswitchng.com/api/v2/quickteller/payments/transfers
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 |
| 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 |
| 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 | ||