feat: (payment) add eBirr as synchronous API_PURCHASE wallet debit

apps/edr-payment-api/src/modules/webhooks/handlers/ebirr-webhook.service.ts

@@ -1,33 +0,0 @@
-import { Injectable } from "@nestjs/common";
-import { EBirrProvider, EBirrWebhookPayload } from "@edr/payment-providers";
-import { WebhookProcessorService } from "../webhook-processor.service";
-
-@Injectable()
-export class EBirrWebhookService {
-  constructor(
-    private readonly provider: EBirrProvider,
-    private readonly processor: WebhookProcessorService,
-  ) {}
-
-  async handle(payload: EBirrWebhookPayload): Promise<void> {
-    const signatureValid = this.provider.verifyWebhookSignature(
-      payload as unknown as Record<string, unknown>,
-    );
-    const mapped = this.provider.mapWebhookStatus(payload.tradeStatus);
-
-    await this.processor.process({
-      provider: this.provider.method,
-      externalEventId: `${payload.orderNo}_${payload.tradeStatus}_${payload.timestamp}`,
-      merchantOrderId: payload.orderNo,
-      providerTxnId: payload.tradeNo,
-      signatureValid,
-      rawStatus: payload.tradeStatus,
-      payload: payload as unknown as Record<string, unknown>,
-      result: {
-        status: mapped,
-        providerTxnId: payload.tradeNo,
-        failureCode: payload.tradeStatus,
-      },
-    });
-  }
-}

apps/edr-payment-api/src/modules/webhooks/webhooks.controller.ts

@@ -14,14 +14,12 @@ import {
   CardWebhookPayload,
   CbeBirrWebhookPayload,
   DMoneyWebhookPayload,
-  EBirrWebhookPayload,
   TelebirrWebhookPayload,
   WaafiWebhookHeaders,
   WaafiWebhookPayload,
 } from "@edr/payment-providers";
 import { TelebirrWebhookService } from "./handlers/telebirr-webhook.service";
 import { CbeBirrWebhookService } from "./handlers/cbe-birr-webhook.service";
-import { EBirrWebhookService } from "./handlers/ebirr-webhook.service";
 import { CardWebhookService } from "./handlers/card-webhook.service";
 import { WaafiWebhookService } from "./handlers/waafi-webhook.service";
 import { DMoneyWebhookService } from "./handlers/dmoney-webhook.service";
@@ -40,7 +38,6 @@ export class WebhooksController {
   constructor(
     private readonly telebirr: TelebirrWebhookService,
     private readonly cbeBirr: CbeBirrWebhookService,
-    private readonly eBirr: EBirrWebhookService,
     private readonly card: CardWebhookService,
     private readonly waafi: WaafiWebhookService,
     private readonly dMoney: DMoneyWebhookService,
@@ -89,17 +86,9 @@ export class WebhooksController {
     return { success: true };
   }
 
-  @Post("ebirr")
-  @HttpCode(HttpStatus.OK)
-  @ApiOperation({ summary: "eBirr payment notification callback (Ethiopia)" })
-  async receiveEBirr(@Body() payload: EBirrWebhookPayload) {
-    try {
-      await this.eBirr.handle(payload);
-    } catch (err) {
-      this.logger.error(`eBirr webhook handler threw: ${this.message(err)}`);
-    }
-    return { code: "0000", message: "success" };
-  }
+  // No eBirr route by design: EbirrPay's API-payment flow has no callback. The API_PURCHASE
+  // response is the settlement notification, and API_GETTRANINFO is the authority for a missing
+  // or ambiguous one — see docs/ebirr/INTEGRATION.md.
 
   @Post("card")
   @HttpCode(HttpStatus.OK)

apps/edr-payment-api/src/modules/webhooks/webhooks.module.ts

@@ -8,7 +8,6 @@ import { WebhookProcessorService } from "./webhook-processor.service";
 import { WebhooksController } from "./webhooks.controller";
 import { TelebirrWebhookService } from "./handlers/telebirr-webhook.service";
 import { CbeBirrWebhookService } from "./handlers/cbe-birr-webhook.service";
-import { EBirrWebhookService } from "./handlers/ebirr-webhook.service";
 import { CardWebhookService } from "./handlers/card-webhook.service";
 import { WaafiWebhookService } from "./handlers/waafi-webhook.service";
 import { DMoneyWebhookService } from "./handlers/dmoney-webhook.service";
@@ -25,7 +24,6 @@ import { DMoneyWebhookService } from "./handlers/dmoney-webhook.service";
     WebhookProcessorService,
     TelebirrWebhookService,
     CbeBirrWebhookService,
-    EBirrWebhookService,
     CardWebhookService,
     WaafiWebhookService,
     DMoneyWebhookService,