Package io.github.openpaydev.mpesa

Class MpesaClient

java.lang.Object

io.github.openpaydev.mpesa.MpesaClient

All Implemented Interfaces:

C2bService, StkPushService

public class MpesaClient
extends Object
implements StkPushService, C2bService

The main client for interacting with the Safaricom M-Pesa API. This class implements the StkPushService and C2bService interfaces.

Constructor Summary

Constructors

Constructor	Description
MpesaClient(MpesaConfig config, TokenManager tokenManager, okhttp3.OkHttpClient client)

Method Summary

Modifier and Type	Method	Description
StkStatusQueryResponse	queryStkStatus(String checkoutRequestID)	Queries the status of an STK Push transaction.
C2bRegisterUrlResponse	registerC2bUrl(C2bRegisterUrlRequest userRequest)	ADD THIS NEW METHOD IMPLEMENTATION
StkPushResponse	stkPush(StkPushRequest userRequest)	Initiates an M-Pesa STK Push request.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Details

MpesaClient

public MpesaClient(MpesaConfig config,
 TokenManager tokenManager,
 okhttp3.OkHttpClient client)

Method Details

stkPush

public StkPushResponse stkPush(StkPushRequest userRequest)
                        throws MpesaException

Description copied from interface: StkPushService

Initiates an M-Pesa STK Push request.

Specified by:

stkPush in interface StkPushService

Parameters:

userRequest - The STK Push request object.

Returns:

The initial synchronous response from the API.

Throws:

MpesaException - If a network or API error occurs.

queryStkStatus

public StkStatusQueryResponse queryStkStatus(String checkoutRequestID)
                                      throws MpesaException

Description copied from interface: StkPushService

Queries the status of an STK Push transaction.

Specified by:

queryStkStatus in interface StkPushService

Parameters:

checkoutRequestID - The unique ID of the transaction to query.

Returns:

The response containing the transaction status details.

Throws:

MpesaException - If a network or API error occurs.

registerC2bUrl

public C2bRegisterUrlResponse registerC2bUrl(C2bRegisterUrlRequest userRequest)
                                      throws MpesaException

ADD THIS NEW METHOD IMPLEMENTATION

Specified by:

registerC2bUrl in interface C2bService

Parameters:

userRequest - The C2B registration request object.

Returns:

The response confirming the registration.

Throws:

MpesaException - If a network or API error occurs.