momo-api-sdk/io.rekast.sdk.repository/DefaultRepository

DefaultRepository

@Singleton

class DefaultRepository @Inject constructor(defaultSource: DefaultSource, disbursementsService: DisbursementsService, collection: CollectionService, basicAuthCredentialsT: BasicAuthCredentials, accessTokenCredentialsT: AccessTokenCredentials) : DataResponse

The DefaultRepository class is responsible for making network calls to the MTN MOMO APIs.

This class holds all the common API methods for various MTN MOMO products, including user management, transaction processing, and status checks.

Constructors

DefaultRepository

@Inject

constructor(defaultSource: DefaultSource, disbursementsService: DisbursementsService, collection: CollectionService, basicAuthCredentialsT: BasicAuthCredentials, accessTokenCredentialsT: AccessTokenCredentials)

Functions

checkApiUser

fun checkApiUser(apiVersion: String, productSubscriptionKey: String): Flow<NetworkResult<ApiUser>>

Checks whether the supplied API user exists.

createApiKey

fun createApiKey(apiVersion: String, productSubscriptionKey: String): Flow<NetworkResult<ApiKey>>

Gets the API Key based on the ApiUser Id and OCP Subscription Id.

createApiUser

fun createApiUser(providerCallBackHost: ProviderCallBackHost, apiVersion: String, uuid: String, productSubscriptionKey: String): Flow<NetworkResult<ApiUser>>

Creates a new API user.

deposit

suspend fun deposit(accessToken: String, momoTransaction: MomoTransaction, apiVersion: String, productSubscriptionKey: String, uuid: String): Response<Unit>

Requests a deposit to be processed.

getAccessToken

fun getAccessToken(productSubscriptionKey: String, productType: String): Flow<NetworkResult<AccessToken>>

Gets the Access Token based on the ApiUser ID, OCP Subscription Id, and the API Key.

getAccessTokenAuth

fun getAccessTokenAuth(): AccessTokenCredentials

Retrieves the current access token authentication credentials.

getAccountBalance

fun getAccountBalance(productType: String, apiVersion: String, currency: String?, productSubscriptionKey: String, environment: String): Flow<NetworkResult<AccountBalance>>

Gets the account balance of the entity/user initiating the transaction. This only works with the ProductType.COLLECTION. It seems to break with the other API products. User EUR as the currency on sandbox

getBasicAuth

fun getBasicAuth(): BasicAuthCredentials

Retrieves the current basic authentication credentials.

getBasicUserInfo

fun getBasicUserInfo(productType: String, apiVersion: String, accountHolder: String, productSubscriptionKey: String, environment: String): Flow<NetworkResult<BasicUserInfo>>

Retrieves the basic user information for a specified MTN MOMO user.

getDepositStatus

suspend fun getDepositStatus(referenceId: String, apiVersion: String, productSubscriptionKey: String, accessToken: String): Response<ResponseBody>

Gets the status of a deposit transaction.

getOauthAccessToken

fun getOauthAccessToken(productType: String, productSubscriptionKey: String, environment: String): Flow<NetworkResult<Oauth2AccessToken>>

Gets the Access Token based on the ApiUser ID, OCP Subscription Id, and the API Key.

getRefundStatus

suspend fun getRefundStatus(referenceId: String, apiVersion: String, productSubscriptionKey: String, accessToken: String): Response<ResponseBody>

Gets the status of a refund transaction.

getTransferStatus

fun getTransferStatus(productType: String, apiVersion: String, referenceId: String, productSubscriptionKey: String, environment: String): Flow<NetworkResult<ResponseBody>>

Retrieves the status of a transfer based on the provided transfer ID.

getUserInfoWithConsent

fun getUserInfoWithConsent(productType: String, apiVersion: String, productSubscriptionKey: String, environment: String): Flow<NetworkResult<UserInfoWithConsent>>

Retrieves the user information for a specified MTN MOMO user with consent.

refund

suspend fun refund(accessToken: String, momoTransaction: MomoTransaction, apiVersion: String, productSubscriptionKey: String, uuid: String): Response<Unit>

Requests a refund to be processed.

requestToPay

suspend fun requestToPay(accessToken: String, momoTransaction: MomoTransaction, apiVersion: String, productSubscriptionKey: String, uuid: String): Response<Unit>

Requests a payment to be processed.

requestToPayDeliveryNotification

fun requestToPayDeliveryNotification(productType: String, apiVersion: String, referenceId: String, momoNotification: MomoNotification, productSubscriptionKey: String, environment: String): Flow<NetworkResult<ResponseBody>>

Sends a request to pay a user, identified by the provided reference ID.

requestToPayTransactionStatus

suspend fun requestToPayTransactionStatus(referenceId: String, apiVersion: String, productSubscriptionKey: String, accessToken: String): Response<ResponseBody>

Requests the status of a payment transaction.

requestToWithdraw

suspend fun requestToWithdraw(accessToken: String, momoTransaction: MomoTransaction, apiVersion: String, productSubscriptionKey: String, uuid: String): Response<Unit>

Requests a withdrawal to be processed.

requestToWithdrawTransactionStatus

suspend fun requestToWithdrawTransactionStatus(referenceId: String, apiVersion: String, productSubscriptionKey: String, accessToken: String): Response<ResponseBody>

Requests the status of a withdrawal transaction.

safeApiCall

suspend fun <T> safeApiCall(apiRequest: suspend () -> Response<T>): NetworkResult<T>

Safely makes an API call and returns the result.

setUpAccessTokenAuth

fun setUpAccessTokenAuth(accessTokenCredentials: AccessTokenCredentials)

Sets up access token authentication credentials.

setUpBasicAuth

fun setUpBasicAuth(basicAuthCredentials: BasicAuthCredentials)

Sets up basic authentication credentials.

transfer

fun transfer(productType: String, apiVersion: String, momoTransaction: MomoTransaction, uuid: String, productSubscriptionKey: String, environment: String): Flow<NetworkResult<Unit>>

Sends a request to transfer funds to a specified account.

validateAccountHolderStatus

fun validateAccountHolderStatus(productType: String, apiVersion: String, accountHolder: AccountHolder, productSubscriptionKey: String, environment: String): Flow<NetworkResult<ResponseBody>>

Validates the status of an account holder.