Foreign Exchange

Scope

This applies to scenarios where end users are making an exchange:

1. From foreign currency (USD/GBP/EUR/CNY/TZS/UGX/RWF) to KES

2. From KES to foreign currency (USD/GBP/EUR/CNY/TZS/UGX/RWF)

Steps

1

Query Live FX rate

Call endpoint /query/v2/getForeignExchangeRate to initiate a transfer request

2

Initiate FX Request

Call endpoint /trans/v2/applyForFcExchange to initiate a transfer request

Status: 1-SUBMITTED

3

Confirm OTP

Call endpoint /common/sendOtp to request for OTP, filling the value of applicationId to businessId parameter. Call endpoint /common/confirmOperation to confirm the OTP code received.

Status: 2-PROCESSING

The endpoint /common/sendOtp can also be used to resend OTP.

4

Processing

Status: 2-PROCESSING

5

Get Onboarding Result

• Get it from 0013 - Foreign Exchange Result Notification

• Query transaction status by calling the endpoint /query/v2/getFxRequestStatus

Status