feat: add MBWay and Wero APM integrations by Bala1324 · Pull Request #198 · paypal-examples/v6-web-sdk-sample-integration

Bala1324 · 2026-03-17T11:00:27Z

This PR adds sample integrations for two new Alternative Payment Methods (APMs) — MBWay and Wero

Changes

Client
MbWay

client/components/mbwayPayments/html/src/app.js — MBWay payment flow: SDK initialization with testBuyerCountry: "PT", eligibility check, createMbWayOneTimePaymentSession, name + email SDK fields, custom phone number inputs (country code+ national number), validation, and popup flow
client/components/mbwayPayments/html/src/index.html — HTML page for MBWay with and phone number inputs
client/components/mbwayPayments/html/README.md — Full setup and integration documentation for MBWay

Wero

client/components/weroPayments/html/src/app.js — Wero payment flow: SDK initialization with testBuyerCountry: "DE", eligibility check, createWeroOneTimePaymentSession, name SDK field, validation, and popup flow
client/components/weroPayments/html/src/index.html — HTML page for Wero with
client/components/weroPayments/html/README.md — Full setup and integration documentation for Wero
client/index.html — Added navigation links for MBWay and Wero

Server

server/node/src/paypalServerSdkClient.ts — Exported PAYPAL_BASE_URL constant for sandbox/production environment switching
server/node/src/routes/ordersRouteHandler.ts — Added ClientOrderPayloadSchema and dual-path logic in createOrderForOneTimePaymentRouteHandler: detects raw purchase_units payload (used by APMs) and makes a direct REST API call to support processing_instruction: ORDER_COMPLETE_ON_PAYMENT_APPROVAL. Also added getOrderRouteHandler to fetch order details post-approval
server/node/src/routes/index.ts — Registered GET /paypal-api/checkout/orders/:orderId route

gregjopa · 2026-03-18T13:47:30Z

+  value: z.string(),
+});
+
+const ClientOrderPayloadSchema = z.object({


Are you able to implement these new APMs without any Order creation changes? We cannot accept purchase_units from the client code. We need to abstract this.

Agreed, this is a blocker to merging, we cannot teach purchase_units to be passed in from the client side

Removed ClientOrderPayloadSchema and the purchase_units path entirely. Client now sends only {currencyCode, processingInstruction } -- no purchase_units from client. Server builds the order payload using OneTimePaymentSchema.

gregjopa · 2026-03-18T13:52:54Z

 );

+router.get(
+  "/paypal-api/checkout/orders/:orderId",


Suggested change

"/paypal-api/checkout/orders/:orderId",

Can we use the existing "/paypal-api/checkout/orders/create-order-for-one-time-payment" route for this behavior and add a new optional param to it for processingInstruction?

Reused the existing /paypal-api/checkout/orders/create-order-for-one-time-payment route and added processingInstruction as an optional param

dwilliams27

Some comments that should be addressed

dwilliams27 · 2026-03-31T16:08:18Z

+  value: z.string(),
+});
+
+const ClientOrderPayloadSchema = z.object({


Agreed, this is a blocker to merging, we cannot teach purchase_units to be passed in from the client side

dwilliams27 · 2026-03-31T16:09:00Z

 );

+router.get(
+  "/paypal-api/checkout/orders/:orderId",


dwilliams27 · 2026-03-31T16:13:45Z

  for (const { sku, quantity } of cart) {
    const { name, price } = getProduct(sku);
-    totalAmount += Number.parseFloat(price) * quantity;
+    totalAmount += parseFloat(price) * quantity;


This should be left as Number.parseFloat

Reverted back to Number.parseFloat. Fixed.

dwilliams27 · 2026-03-31T16:14:31Z

+      // console.log(
+      //   "[createOrderForOneTimePayment] Orders payload sent to v2/checkout/orders:",
+      //   JSON.stringify(parsed, null, 2),
+      // );


These commented out debug log blocks should all be removed before merging

Removed all commented out debug log blocks.

dwilliams27 · 2026-03-31T16:16:04Z


  response.status(statusCode).json(result);
-}
+}


Was newline removed here?

Fixed. Added newline at end of file.

dwilliams27 · 2026-03-31T16:16:23Z

  throw new Error("Missing API credentials");
 }

+export const PAYPAL_BASE_URL ="https://api-m.sandbox.paypal.com";


This shouldn't be needed once fetch is removed

Agreed. Removed PAYPAL_BASE_URL and direct fetch. processingInstruction is now handled via ProcessingInstruction.OrderCompleteOnPaymentApproval enum from the SDK. The enum exists in the SDK source but not yet published to npm — raised a PR to the SDK repo. Once merged and released, this will work cleanly without any direct fetch.

gregjopa · 2026-04-06T13:54:32Z

+   ```
+   The server will run on `http://localhost:8080`
+
+### Client Setup


I think these client steps are no longer needed. All a developer has to do is run the server for static examples like this. Ex:

cd server/node npm install npm start

Removed the Client Setup section from both the MBWay and Wero README files. Developers only need to run the server for static examples.

gregjopa · 2026-04-06T13:55:30Z

 ) {
  const { currencyCode, totalAmount, items } = OneTimePaymentSchema.parse(
-    request.body ?? {},
+    request.body,


Please add this back. There are use cases where the POST body is empty so we want it to default to an empty object.

Suggested change

request.body,

request.body ?? {},

Added ?? {} back to default to an empty object when the POST body is empty.

…outeHandler

Bala1324 requested a review from a team as a code owner March 17, 2026 11:00

gregjopa reviewed Mar 18, 2026

View reviewed changes

dwilliams27 reviewed Mar 31, 2026

View reviewed changes

feat: add MBWay and Wero APM integrations

650178e

Bala1324 force-pushed the feature/mbway-devdocs branch from 7912441 to 650178e Compare April 1, 2026 05:54

Balachandiran E (CW) added 3 commits April 6, 2026 11:46

comment are fixed

0f36b54

removed /order fetch and imaplemented the processing instruction

d561fbd

fix: address PR review comments for MBWay and Wero APM integrations

0c9cb4e

gregjopa reviewed Apr 6, 2026

View reviewed changes

Balachandiran E (CW) added 2 commits April 7, 2026 18:53

fix: fix prettier formatting in mbway and wero files

9d4d2e8

fix: address PR review comments for MBWay and Wero README and ordersR…

22c015f

…outeHandler

Conversation

Bala1324 commented Mar 17, 2026

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

dwilliams27 left a comment

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Bala1324 Apr 6, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

Bala1324 Apr 6, 2026 •

edited

Loading