(20250225)

api/blueprints/finstitutions/payments/request_v2.py

@@ -206,7 +206,8 @@ async def request_payment(
     return ResponseModel(
         status_code = StatusCodes.OK if response.success else StatusCodes.FAILED,
         http_code = HttpCodes.SUCCESS if response.success else HttpCodes.INTERNAL_SERVER_ERROR,
-        message = response.message
+        message = response.message,
+        data = {"paymentId": str(response.paymentId)}
     )
 
 

controllers_v2/finstitutions/payments/safaricom_mpesa_express.py

@@ -198,6 +198,7 @@ class SafaricomMPesaExpressPaymentsController(PaymentsController):
             payment_request = payment_request,
             tags = ["Payment", "Safaricom", "M-Pesa Express", "Kenya"]
         )
+        result.paymentId = payment_id
 
         # Initialize the third-party client:
         client_auth = MPesaExpressAuthorization(

models/api/finstitutions/payments/request.py

@@ -263,6 +263,11 @@ class PGPaymentRequestData(BaseModel):
 
 class PaymentRequestOneResult(BaseModel):
 
+    paymentId: ObjectId | None = Field(
+        description = "the id of this payment's record",
+        default = None
+    )
+
     success: bool = Field(
         description = "whether, or not, the payment was successfully requested",
         default = False
@@ -280,6 +285,7 @@ class PaymentRequestOneResult(BaseModel):
 
     class Config:
         extra = "forbid"
+        arbitrary_types_allowed = True
 
 
 # ---------------------------------------------------------------------------------------------------------------------