feat(connector): [Peachpayments] Add Webhook Flow and Support For merchant_order_reference_id by Anurag-05-prog · Pull Request #9781 · juspay/hyperswitch

Anurag-05-prog · 2025-10-10T03:49:42Z

Type of Change

Closes this issue

Description

Added Webhook Flow and Support for merchant_order_reference_id for Peachpayments

Additional Changes

This PR modifies the API contract
This PR modifies the database schema
This PR modifies application configuration/environment variables

Motivation and Context

How did you test it?

Set verify_webhook_source to true

async fn verify_webhook_source(
    &self,
    _request: &webhooks::IncomingWebhookRequestDetails<'_>,
    _merchant_id: &id_type::MerchantId,
    _connector_webhook_details: Option<common_utils::pii::SecretSerdeValue>,
    _connector_account_details: common_utils::crypto::Encryptable<Secret<serde_json::Value>>,
    _connector_name: &str,
) -> CustomResult<bool, errors::ConnectorError> {
    Ok(true)
}

Host localhost in ngork and run this curl:

curl --location '{{ngrokUrl}}/webhooks/:mid/:mca' \
--header 'Content-Type: application/json' \
--data-raw '{
  "rule": {},
  "webhookId": "000a262d-6eb9-425e-8f58-a659a771f11a",
  "transaction": {
    "referenceId": "pay_CyHp5Gty8N6y7bGBtznE_1",
    "responseCode": {
      "value": "00",
      "description": "Approved or completed successfully",
      "explanation": "Transaction approved by acquirer or issuer. Other factors may impact the final outcome of the transaction.",
      "receiptString": "Approved",
      "isoCodeDescription": "Approved or completed successfully",
      "terminalOutcomeString": "Approved"
    },
    "paymentMethod": "ecommerce_card_payment_only",
    "transactionId": "b5438722-06c9-4f44-b8d7-9d3d5768098f",
    "transactionTime": "2025-10-10T02:16:15.562551Z",
    "transactionType": {
      "value": 0,
      "description": "Goods and Services"
    },
    "transactionResult": "approved_confirmed",
    "voidableUntilTime": "2025-10-10T22:00:00Z",
    "cardNotPresentRefundableStatus": "not_refundable",
    "ecommerceCardPaymentOnlyTransactionData": {
      "rrn": "711184317168",
      "card": {
        "scheme": "Visa",
        "binNumber": "400000",
        "maskedPan": "400000******0446",
        "expiryYear": "26",
        "expiryMonth": "12",
        "cardholderName": "joseph Doe"
      },
      "stan": "573152",
      "amount": {
        "amount": 200,
        "currencyCode": "ZAR",
        "displayValue": "R2.00"
      },
      "traceId": "001760062576462",
      "approvalCode": "863244",
      "settlementDate": "2025-10-10"
    }
  },
  "webhookTime": "2025-10-10T02:16:30.882493869Z",
  "webhookType": "transaction"
}'

Response:

200 OK Status

Incoming Webhook Screenshot:

Checklist

I formatted the code cargo +nightly fmt --all
I addressed lints thrown by cargo clippy
I reviewed the submitted code
I added unit tests for my changes where possible

…chant_order_reference_id

semanticdiff-com · 2025-10-10T03:49:44Z

Review changes with

Changed Files

File	Status
crates/hyperswitch_connectors/src/connectors/peachpayments/transformers.rs	28% smaller
crates/hyperswitch_connectors/src/connectors/peachpayments.rs	7% smaller

crates/hyperswitch_connectors/src/connectors/peachpayments/transformers.rs

crates/hyperswitch_connectors/src/connectors/peachpayments.rs

deepanshu-iiitu · 2025-10-14T08:08:02Z

crates/hyperswitch_connectors/src/connectors/peachpayments.rs

+        let payments_response = peachpayments::PeachpaymentsPaymentsResponse {
+            transaction_id: transaction.transaction_id.clone(),
+            response_code: transaction.response_code,
+            transaction_result: transaction.transaction_result,
+            ecommerce_card_payment_only_transaction_data: transaction
+                .ecommerce_card_payment_only_transaction_data,
+            original_transaction_id: transaction.original_transaction_id,
+            reference_id: Some(transaction.reference_id),
+            error_message: transaction.error_message,
+            payment_method: Some(transaction.payment_method),
+        };


Instead of creating a new struct PeachpaymentsIncomingWebhook and then parsing it to PeachpaymentsPaymentsResponse

Make PeachpaymentsPaymentsResponse an enum with 2 structs 1 for payments and 1 for webhooks

Refere Adyen

swetasharma03 · 2025-10-14T08:22:41Z

crates/hyperswitch_connectors/src/connectors/peachpayments.rs

+        Ok(Box::new(payments_response))
+    }
+
+    async fn verify_webhook_source(


Do we have information on source_verification_algorithm for this connector?
If so, can we add implementations for get_webhook_source_verification_algorithm, get_webhook_source_verification_signature, and get_webhook_source_verification_message as well?

Peach doesn't support any algorithm as of now.

…ts-webhook

deepanshu-iiitu · 2025-10-15T07:19:37Z

crates/hyperswitch_connectors/src/connectors/peachpayments/transformers.rs

+    pub original_transaction_id: Option<String>,
+    pub reference_id: Option<String>,
+    pub error_message: Option<String>,
+    pub payment_method: Option<Secret<String>>,


Why are we modifying the existing PeachpaymentsPaymentsData?

Not needed, removing it

…chant_order_reference_id (#9781) Co-authored-by: Anurag Singh <anurag.singh.001@MacBookPro.lan> Co-authored-by: Anurag Singh <anurag.singh.001@Anurag-Singh-WPMHJ5619X.local>

…chant_order_reference_id (juspay#9781) Co-authored-by: Anurag Singh <anurag.singh.001@MacBookPro.lan> Co-authored-by: Anurag Singh <anurag.singh.001@Anurag-Singh-WPMHJ5619X.local>

…chant_order_reference_id (#9781) Co-authored-by: Anurag Singh <anurag.singh.001@MacBookPro.lan> Co-authored-by: Anurag Singh <anurag.singh.001@Anurag-Singh-WPMHJ5619X.local>

…chant_order_reference_id (juspay#9781) Co-authored-by: Anurag Singh <anurag.singh.001@MacBookPro.lan> Co-authored-by: Anurag Singh <anurag.singh.001@Anurag-Singh-WPMHJ5619X.local>

feat(connector): [Peachpayments] add webhook flow and support for mer…

1c27e1d

…chant_order_reference_id

Anurag-05-prog self-assigned this Oct 10, 2025

Anurag-05-prog requested a review from a team as a code owner October 10, 2025 03:49

Anurag-05-prog linked an issue Oct 10, 2025 that may be closed by this pull request

[FEATURE] Peachpayments: Add Webhook Flow and Support For Merchant_Order_Reference_Id #9780

Closed

2 tasks

deepanshu-iiitu requested changes Oct 10, 2025

View reviewed changes

Anurag Singh and others added 2 commits October 12, 2025 21:59

refactor: resolve comments

72a65e1

Merge remote-tracking branch 'origin/main' into peachpayments-webhook

e6451b2

AkshayaFoiger previously approved these changes Oct 14, 2025

View reviewed changes

deepanshu-iiitu reviewed Oct 14, 2025

View reviewed changes

swetasharma03 reviewed Oct 14, 2025

View reviewed changes

Anurag Singh added 2 commits October 15, 2025 00:40

refactor: resolve comments

3d47e15

Merge branch 'main' of github.com:juspay/hyperswitch into peachpaymen…

e0fdc4d

…ts-webhook

Anurag-05-prog dismissed AkshayaFoiger’s stale review via e0fdc4d October 14, 2025 19:13

Anurag-05-prog force-pushed the peachpayments-webhook branch from a16bc1c to e0fdc4d Compare October 14, 2025 19:13

deepanshu-iiitu reviewed Oct 15, 2025

View reviewed changes

refactor: resolve comments

35b3dc1

deepanshu-iiitu approved these changes Oct 15, 2025

View reviewed changes

swetasharma03 approved these changes Oct 15, 2025

View reviewed changes

likhinbopanna enabled auto-merge October 15, 2025 08:06

likhinbopanna added this pull request to the merge queue Oct 15, 2025

Merged via the queue into main with commit 6394c89 Oct 15, 2025
24 of 30 checks passed

likhinbopanna deleted the peachpayments-webhook branch October 15, 2025 16:01

Anurag-05-prog mentioned this pull request Oct 16, 2025

feat(connector): [Peachpayments] Add Webhook Flow and Support For merchant_order_reference_id #9882

Merged

14 tasks

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

feat(connector): [Peachpayments] Add Webhook Flow and Support For merchant_order_reference_id#9781

feat(connector): [Peachpayments] Add Webhook Flow and Support For merchant_order_reference_id#9781
likhinbopanna merged 6 commits intomainfrom
peachpayments-webhook

Anurag-05-prog commented Oct 10, 2025 •

edited

Loading

Uh oh!

semanticdiff-com bot commented Oct 10, 2025 •

edited

Loading

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

deepanshu-iiitu Oct 14, 2025

Uh oh!

swetasharma03 Oct 14, 2025

Uh oh!

Anurag-05-prog Oct 14, 2025

Uh oh!

deepanshu-iiitu Oct 15, 2025

Uh oh!

Anurag-05-prog Oct 15, 2025

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

5 participants

Conversation

Anurag-05-prog commented Oct 10, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Type of Change

Description

Additional Changes

Motivation and Context

How did you test it?

Checklist

Uh oh!

semanticdiff-com bot commented Oct 10, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

deepanshu-iiitu Oct 14, 2025

Choose a reason for hiding this comment

Uh oh!

swetasharma03 Oct 14, 2025

Choose a reason for hiding this comment

Uh oh!

Anurag-05-prog Oct 14, 2025

Choose a reason for hiding this comment

Uh oh!

deepanshu-iiitu Oct 15, 2025

Choose a reason for hiding this comment

Uh oh!

Anurag-05-prog Oct 15, 2025

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

5 participants

Anurag-05-prog commented Oct 10, 2025 •

edited

Loading

semanticdiff-com bot commented Oct 10, 2025 •

edited

Loading