Introduction
Overview
SwitchIT is an API for eTranzact’s partners to leverage our African reach to remit foreign currencies to bank accounts in African countries, as well as power cash pickup/out operations via mobile money agents of respective banks.
Before sending a requests, please note this:
- Client will provide eTranzact with the IP Address of their system (on test and on live environments) for whitelisting.
- eTranzact would provide Client with test parameters which includes terminal id, pin, MasterKey for pin encryption.
- Plain text pins must be encrypted using AES Algorithm, using MasterKey as the encryption key.
- SwitchIT supports only TLSV 1.2. All requests not secured with TLS v1.2 will be rejected.
- All client requests must include a unique reference id.
SANDBOX TEST PARAMETERS
| Parameter | Value |
|---|---|
| Terminal id | 7000000004 |
| Pin | 0006 |
| AES encrypted PIN | kghxqwveJ3eSQJip/cmaMQ== |
| Master key(encryption key) | KEd4gDNSDdMBxCGliZaC8w== |
| Demo Base URL (funds transfer module) | https://demo.etranzact.com/switchitremittance/api/v1 |
| Bank account number | 6580009213 |
| Bank code | 050 |
| Destination Country | KE |
| Mobile number | 2349012345678 |
LIST OF ALLOWED ACTIONS (Request types)
| S/No | ACTION | DESCRIPTION |
|---|---|---|
| 1 | FT | Funds transfer |
| 2 | AQ | Account Query |
| 3 | RT | Currency Conversion Rate |
| 4 | BL | Bank and mobile money operators list for specified country |
| 5 | TS | Transaction Status |
| 6 | CP | Cash Pickup via agents |