vona-module-pay-paypal 5.0.2 → 5.0.3

package/dist/bean/payProvider.paypal.d.ts

@@ -12,10 +12,12 @@ export interface IPayProviderPaypalClientOptions extends IPayProviderClientOptio
 export interface IPayProviderOptionsPaypal extends IDecoratorPayProviderOptions<IPayProviderPaypalClientRecord, IPayProviderPaypalClientOptions> {
 }
 export declare class PayProviderPaypal extends BeanBase implements IPayProviderExecute<IPayProviderPaypalClientOptions> {
-    startPayment(_input: IPayProviderPaymentInput, _clientOptions: IPayProviderPaypalClientOptions): Promise<IPayProviderPaymentSnapshot>;
-    queryPayment(_input: IPayProviderPaymentInput, _clientOptions: IPayProviderPaypalClientOptions): Promise<IPayProviderPaymentSnapshot>;
-    createRefund(_input: IPayProviderRefundInput, _clientOptions: IPayProviderPaypalClientOptions): Promise<IPayProviderRefundSnapshot>;
+    startPayment(input: IPayProviderPaymentInput, clientOptions: IPayProviderPaypalClientOptions): Promise<IPayProviderPaymentSnapshot>;
+    queryPayment(input: IPayProviderPaymentInput, clientOptions: IPayProviderPaypalClientOptions): Promise<IPayProviderPaymentSnapshot>;
+    createRefund(input: IPayProviderRefundInput, clientOptions: IPayProviderPaypalClientOptions): Promise<IPayProviderRefundSnapshot>;
+    queryRefund(_input: IPayProviderRefundInput, _clientOptions: IPayProviderPaypalClientOptions): Promise<IPayProviderRefundSnapshot>;
     verifyWebhook(_input: IPayProviderWebhookInput, _clientOptions: IPayProviderPaypalClientOptions): Promise<IPayProviderVerifiedWebhook>;
+    private _createClient;
 }
 declare module 'vona-module-a-pay' {
     interface IPayProviderRecord {

package/dist/bean/payProvider.paypal.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"payProvider.paypal.d.ts","sourceRoot":"","sources":["../../src/bean/payProvider.paypal.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,4BAA4B,EAC5B,yBAAyB,EACzB,wBAAwB,EACxB,mBAAmB,EACnB,wBAAwB,EACxB,2BAA2B,EAC3B,uBAAuB,EACvB,0BAA0B,EAC1B,2BAA2B,EAC3B,wBAAwB,EACzB,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EAAE,QAAQ,EAAU,MAAM,MAAM,CAAC;AAGxC,MAAM,WAAW,8BAA+B,SAAQ,wBAAwB;CAAG;AAEnF,MAAM,WAAW,+BAAgC,SAAQ,yBAAyB;IAChF,gBAAgB,EAAE;QAAE,QAAQ,EAAE,MAAM,GAAG,SAAS,CAAC;QAAC,YAAY,EAAE,MAAM,GAAG,SAAS,CAAA;KAAE,CAAC;IACrF,SAAS,EAAE,MAAM,GAAG,SAAS,CAAC;CAC/B;AAID,MAAM,WAAW,yBAA0B,SAAQ,4BAA4B,CAC7E,8BAA8B,EAC9B,+BAA+B,CAChC;CAAG;AAEJ,qBAuBa,iBACX,SAAQ,QACR,YAAW,mBAAmB,CAAC,+BAA+B,CAAC;IAEzD,YAAY,CAChB,MAAM,EAAE,wBAAwB,EAChC,cAAc,EAAE,+BAA+B,GAC9C,OAAO,CAAC,2BAA2B,CAAC;IAIjC,YAAY,CAChB,MAAM,EAAE,wBAAwB,EAChC,cAAc,EAAE,+BAA+B,GAC9C,OAAO,CAAC,2BAA2B,CAAC;IAIjC,YAAY,CAChB,MAAM,EAAE,uBAAuB,EAC/B,cAAc,EAAE,+BAA+B,GAC9C,OAAO,CAAC,0BAA0B,CAAC;IAIhC,aAAa,CACjB,MAAM,EAAE,wBAAwB,EAChC,cAAc,EAAE,+BAA+B,GAC9C,OAAO,CAAC,2BAA2B,CAAC;CAGxC;AAED,OAAO,QAAQ,mBAAmB,CAAC;IACjC,UAAiB,kBAAkB;QACjC,mBAAmB,EAAE,yBAAyB,CAAC;KAChD;CACF"}
+{"version":3,"file":"payProvider.paypal.d.ts","sourceRoot":"","sources":["../../src/bean/payProvider.paypal.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,4BAA4B,EAC5B,yBAAyB,EACzB,wBAAwB,EACxB,mBAAmB,EACnB,wBAAwB,EACxB,2BAA2B,EAC3B,uBAAuB,EACvB,0BAA0B,EAC1B,2BAA2B,EAC3B,wBAAwB,EACzB,MAAM,mBAAmB,CAAC;AAU3B,OAAO,EAAE,QAAQ,EAAU,MAAM,MAAM,CAAC;AAGxC,MAAM,WAAW,8BAA+B,SAAQ,wBAAwB;CAAG;AAEnF,MAAM,WAAW,+BAAgC,SAAQ,yBAAyB;IAChF,gBAAgB,EAAE;QAAE,QAAQ,EAAE,MAAM,GAAG,SAAS,CAAC;QAAC,YAAY,EAAE,MAAM,GAAG,SAAS,CAAA;KAAE,CAAC;IACrF,SAAS,EAAE,MAAM,GAAG,SAAS,CAAC;CAC/B;AAID,MAAM,WAAW,yBAA0B,SAAQ,4BAA4B,CAC7E,8BAA8B,EAC9B,+BAA+B,CAChC;CAAG;AAEJ,qBAuBa,iBACX,SAAQ,QACR,YAAW,mBAAmB,CAAC,+BAA+B,CAAC;IAEzD,YAAY,CAChB,KAAK,EAAE,wBAAwB,EAC/B,aAAa,EAAE,+BAA+B,GAC7C,OAAO,CAAC,2BAA2B,CAAC;IAkCjC,YAAY,CAChB,KAAK,EAAE,wBAAwB,EAC/B,aAAa,EAAE,+BAA+B,GAC7C,OAAO,CAAC,2BAA2B,CAAC;IA4BjC,YAAY,CAChB,KAAK,EAAE,uBAAuB,EAC9B,aAAa,EAAE,+BAA+B,GAC7C,OAAO,CAAC,0BAA0B,CAAC;IAehC,WAAW,CACf,MAAM,EAAE,uBAAuB,EAC/B,cAAc,EAAE,+BAA+B,GAC9C,OAAO,CAAC,0BAA0B,CAAC;IAIhC,aAAa,CACjB,MAAM,EAAE,wBAAwB,EAChC,cAAc,EAAE,+BAA+B,GAC9C,OAAO,CAAC,2BAA2B,CAAC;IAIvC,OAAO,CAAC,aAAa;CActB;AAgBD,OAAO,QAAQ,mBAAmB,CAAC;IACjC,UAAiB,kBAAkB;QACjC,mBAAmB,EAAE,yBAAyB,CAAC;KAChD;CACF"}

package/dist/index.js

@@ -1,21 +1,131 @@
 import { useApp, BeanInfo, BeanBase, BeanScopeBase } from 'vona';
 import { __decorate } from 'tslib';
+import { OrdersController, CheckoutPaymentIntent, OrderStatus, PaymentsController, Client, Environment } from '@cabloy/paypal-server-sdk';
 import { PayProvider } from 'vona-module-a-pay';
 import { Scope } from 'vona-module-a-bean';
 
 const app = useApp();
 let PayProviderPaypal = class PayProviderPaypal extends BeanBase {
-  async startPayment(_input, _clientOptions) {
-    this.app.throw(501, 'PayPal provider is not configured');
+  async startPayment(input, clientOptions) {
+    if (input.providerOrderId) return await this.queryPayment(input, clientOptions);
+    if (!input.returnUrl || !input.cancelUrl) {
+      this.app.throw(422, 'PayPal payment requires return and cancel URLs');
+    }
+    const orders = new OrdersController(this._createClient(clientOptions));
+    const response = await orders.createOrder({
+      paypalRequestId: input.idempotencyKey,
+      body: {
+        intent: CheckoutPaymentIntent.Capture,
+        applicationContext: {
+          returnUrl: input.returnUrl,
+          cancelUrl: input.cancelUrl
+        },
+        purchaseUnits: [{
+          customId: String(input.paymentSessionId),
+          invoiceId: input.businessReference,
+          amount: {
+            currencyCode: input.currency,
+            value: formatMinorAmount(input.amountMinor, input.currency)
+          }
+        }]
+      }
+    });
+    const order = response.result;
+    const approvalUrl = order?.links?.find(item => item.rel === 'approve')?.href;
+    if (!order?.id || !approvalUrl) this.app.throw(502, 'PayPal did not return an approval order');
+    return {
+      state: 'requires_action',
+      providerPaymentId: order.id,
+      providerOrderId: order.id,
+      nextAction: {
+        kind: 'redirect',
+        url: approvalUrl
+      }
+    };
   }
-  async queryPayment(_input, _clientOptions) {
-    this.app.throw(501, 'PayPal provider is not configured');
+  async queryPayment(input, clientOptions) {
+    if (!input.providerOrderId) return {
+      state: 'requires_action'
+    };
+    const orders = new OrdersController(this._createClient(clientOptions));
+    const response = await orders.getOrder({
+      id: input.providerOrderId
+    });
+    const order = response.result;
+    if (!order?.id) this.app.throw(502, 'PayPal order query returned no order');
+    const capture = order.purchaseUnits?.[0]?.payments?.captures?.[0];
+    if (capture?.status === 'COMPLETED') {
+      return {
+        state: 'succeeded',
+        providerPaymentId: order.id,
+        providerOrderId: order.id,
+        providerCaptureId: capture.id,
+        nextAction: {
+          kind: 'completed'
+        }
+      };
+    }
+    if (capture?.status === 'FAILED' || capture?.status === 'DECLINED') {
+      return {
+        state: 'failed',
+        providerPaymentId: order.id,
+        providerOrderId: order.id
+      };
+    }
+    if (order.status === OrderStatus.Voided) {
+      return {
+        state: 'cancelled',
+        providerPaymentId: order.id,
+        providerOrderId: order.id
+      };
+    }
+    if (capture?.status === 'PENDING') {
+      return {
+        state: 'processing',
+        providerPaymentId: order.id,
+        providerOrderId: order.id
+      };
+    }
+    return {
+      state: 'requires_action',
+      providerPaymentId: order.id,
+      providerOrderId: order.id
+    };
   }
-  async createRefund(_input, _clientOptions) {
-    this.app.throw(501, 'PayPal provider is not configured');
+  async createRefund(input, clientOptions) {
+    const payments = new PaymentsController(this._createClient(clientOptions));
+    const response = await payments.refundCapturedPayment({
+      captureId: input.providerCaptureId,
+      paypalRequestId: input.idempotencyKey,
+      body: {
+        amount: {
+          currencyCode: input.currency,
+          value: formatMinorAmount(input.amountMinor, input.currency)
+        }
+      }
+    });
+    return mapRefund(response.result?.status, response.result?.id);
+  }
+  async queryRefund(_input, _clientOptions) {
+    this.app.throw(501, 'PayPal refund query requires a persisted provider refund identifier');
   }
   async verifyWebhook(_input, _clientOptions) {
-    this.app.throw(501, 'PayPal webhook verification is not configured');
+    this.app.throw(501, 'PayPal webhook verification requires configured webhook verification');
+  }
+  _createClient(clientOptions) {
+    const {
+      clientId,
+      clientSecret
+    } = clientOptions.secretCredential;
+    if (!clientId || !clientSecret) this.app.throw(503, 'PayPal client credentials are not configured');
+    return new Client({
+      clientCredentialsAuthCredentials: {
+        oAuthClientId: clientId,
+        oAuthClientSecret: clientSecret
+      },
+      timeout: 0,
+      environment: clientOptions.environment === 'live' ? Environment.Production : Environment.Sandbox
+    });
   }
 };
 PayProviderPaypal = __decorate([PayProvider({
@@ -43,6 +153,30 @@ PayProviderPaypal = __decorate([PayProvider({
 }), BeanInfo({
   module: "pay-paypal"
 })], PayProviderPaypal);
+function formatMinorAmount(amountMinor, currency) {
+  if (!Number.isSafeInteger(amountMinor) || amountMinor < 0 || currency !== 'USD') {
+    throw new Error('PayPal supports only nonnegative USD minor-unit amounts');
+  }
+  return `${Math.floor(amountMinor / 100)}.${String(amountMinor % 100).padStart(2, '0')}`;
+}
+function mapRefund(status, providerRefundId) {
+  if (status === 'COMPLETED') return {
+    state: 'succeeded',
+    providerRefundId
+  };
+  if (status === 'FAILED') return {
+    state: 'failed',
+    providerRefundId
+  };
+  if (status === 'CANCELLED') return {
+    state: 'cancelled',
+    providerRefundId
+  };
+  return {
+    state: 'pending',
+    providerRefundId
+  };
+}
 
 let ScopeModulePayPaypal = class ScopeModulePayPaypal extends BeanScopeBase {};
 ScopeModulePayPaypal = __decorate([Scope(), BeanInfo({

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sources":["../src/bean/payProvider.paypal.ts","../src/.metadata/index.ts"],"sourcesContent":[null,null],"names":["app","useApp","PayProviderPaypal","BeanBase","startPayment","_input","_clientOptions","throw","queryPayment","createRefund","verifyWebhook","__decorate","PayProvider","base","capabilities","redirectCheckout","embeddedCheckout","automaticCapture","manualCapture","refunds","partialRefunds","webhooks","clients","default","environment","secretCredential","clientId","meta","env","PAYPAL_CLIENT_ID","clientSecret","PAYPAL_CLIENT_SECRET","webhookId","PAYPAL_WEBHOOK_ID","__z_BeanInfo","module","ScopeModulePayPaypal","BeanScopeBase","Scope"],"mappings":";;;;;AAuBA,MAAMA,GAAG,GAAGC,MAAM,EAAE;AA8Bb,IAAMC,iBAAiB,GAAvB,MAAMA,iBACX,SAAQC,QAAQ,CAAA;AAGhB,EAAA,MAAMC,YAAYA,CAChBC,MAAgC,EAChCC,cAA+C,EAAA;IAE/C,IAAI,CAACN,GAAG,CAACO,KAAK,CAAC,GAAG,EAAE,mCAAmC,CAAC;AAC1D,EAAA;AAEA,EAAA,MAAMC,YAAYA,CAChBH,MAAgC,EAChCC,cAA+C,EAAA;IAE/C,IAAI,CAACN,GAAG,CAACO,KAAK,CAAC,GAAG,EAAE,mCAAmC,CAAC;AAC1D,EAAA;AAEA,EAAA,MAAME,YAAYA,CAChBJ,MAA+B,EAC/BC,cAA+C,EAAA;IAE/C,IAAI,CAACN,GAAG,CAACO,KAAK,CAAC,GAAG,EAAE,mCAAmC,CAAC;AAC1D,EAAA;AAEA,EAAA,MAAMG,aAAaA,CACjBL,MAAgC,EAChCC,cAA+C,EAAA;IAE/C,IAAI,CAACN,GAAG,CAACO,KAAK,CAAC,GAAG,EAAE,+CAA+C,CAAC;AACtE,EAAA;;AA9BWL,iBAAiB,GAAAS,UAAA,CAAA,CAvB7BC,WAAW,CAA4B;AACtCC,EAAAA,IAAI,EAAE;AACJC,IAAAA,YAAY,EAAE;AACZC,MAAAA,gBAAgB,EAAE,IAAI;AACtBC,MAAAA,gBAAgB,EAAE,KAAK;AACvBC,MAAAA,gBAAgB,EAAE,IAAI;AACtBC,MAAAA,aAAa,EAAE,KAAK;AACpBC,MAAAA,OAAO,EAAE,IAAI;AACbC,MAAAA,cAAc,EAAE,IAAI;AACpBC,MAAAA,QAAQ,EAAE;AACX;GACF;AACDC,EAAAA,OAAO,EAAE;AACPC,IAAAA,OAAO,EAAE;AACPC,MAAAA,WAAW,EAAE,SAAS;AACtBC,MAAAA,gBAAgB,EAAE;AAChBC,QAAAA,QAAQ,EAAE1B,GAAG,CAAC2B,IAAI,CAACC,GAAG,CAACC,gBAAgB;AACvCC,QAAAA,YAAY,EAAE9B,GAAG,CAAC2B,IAAI,CAACC,GAAG,CAACG;OAC5B;AACDC,MAAAA,SAAS,EAAEhC,GAAG,CAAC2B,IAAI,CAACC,GAAG,CAACK;AACzB;AACF;CACF,CAAC,EAAAC,QAAA,CAAA;EAAAC,MAAA,EAAA;AAAA,CAAA,CAAA,CACW,EAAAjC,iBAAiB,CA+B7B;;AC9CM,IAAMkC,oBAAoB,GAA1B,MAAMA,oBAAqB,SAAQC,aAAa,CAAA;AAA1CD,oBAAoB,GAAAzB,UAAA,CAAA,CADhC2B,KAAK,EAAE,EAAAJ,QAAA,CAAA;EAAAC,MAAA,EAAA;AAAA,CAAA,CAAA,CACK,EAAAC,oBAAoB,CAAyB;AAuB1D;;;;"}
+{"version":3,"file":"index.js","sources":["../src/bean/payProvider.paypal.ts","../src/.metadata/index.ts"],"sourcesContent":[null,null],"names":["app","useApp","PayProviderPaypal","BeanBase","startPayment","input","clientOptions","providerOrderId","queryPayment","returnUrl","cancelUrl","throw","orders","OrdersController","_createClient","response","createOrder","paypalRequestId","idempotencyKey","body","intent","CheckoutPaymentIntent","Capture","applicationContext","purchaseUnits","customId","String","paymentSessionId","invoiceId","businessReference","amount","currencyCode","currency","value","formatMinorAmount","amountMinor","order","result","approvalUrl","links","find","item","rel","href","id","state","providerPaymentId","nextAction","kind","url","getOrder","capture","payments","captures","status","providerCaptureId","OrderStatus","Voided","createRefund","PaymentsController","refundCapturedPayment","captureId","mapRefund","queryRefund","_input","_clientOptions","verifyWebhook","clientId","clientSecret","secretCredential","Client","clientCredentialsAuthCredentials","oAuthClientId","oAuthClientSecret","timeout","environment","Environment","Production","Sandbox","__decorate","PayProvider","base","capabilities","redirectCheckout","embeddedCheckout","automaticCapture","manualCapture","refunds","partialRefunds","webhooks","clients","default","meta","env","PAYPAL_CLIENT_ID","PAYPAL_CLIENT_SECRET","webhookId","PAYPAL_WEBHOOK_ID","__z_BeanInfo","module","Number","isSafeInteger","Error","Math","floor","padStart","providerRefundId","ScopeModulePayPaypal","BeanScopeBase","Scope"],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "vona-module-pay-paypal",
-  "version": "5.0.2",
+  "version": "5.0.3",
   "description": "",
   "keywords": [
     "Vona Module"
@@ -30,7 +30,8 @@
     "postpack": "clean-package restore"
   },
   "dependencies": {
-    "vona-module-a-pay": "5.0.2"
+    "@cabloy/paypal-server-sdk": "2.2.0",
+    "vona-module-a-pay": "5.0.3"
   },
   "title": "pay-paypal",
   "vonaModule": {
@@ -39,5 +40,5 @@
       "a-vona": "5.0.0"
     }
   },
-  "gitHead": "95488ea0a7779f34f6ebddeca7719d8545bc55b3"
+  "gitHead": "e86b8ee51b837417b7b28b2c67862877d4092371"
 }

package/src/bean/payProvider.paypal.ts

@@ -11,6 +11,14 @@ import type {
   IPayProviderWebhookInput,
 } from 'vona-module-a-pay';
 
+import {
+  CheckoutPaymentIntent,
+  Client,
+  Environment,
+  OrdersController,
+  OrderStatus,
+  PaymentsController,
+} from '@cabloy/paypal-server-sdk';
 import { BeanBase, useApp } from 'vona';
 import { PayProvider } from 'vona-module-a-pay';
 
@@ -56,32 +64,133 @@ export class PayProviderPaypal
   implements IPayProviderExecute<IPayProviderPaypalClientOptions>
 {
   async startPayment(
-    _input: IPayProviderPaymentInput,
-    _clientOptions: IPayProviderPaypalClientOptions,
+    input: IPayProviderPaymentInput,
+    clientOptions: IPayProviderPaypalClientOptions,
   ): Promise<IPayProviderPaymentSnapshot> {
-    this.app.throw(501, 'PayPal provider is not configured');
+    if (input.providerOrderId) return await this.queryPayment(input, clientOptions);
+    if (!input.returnUrl || !input.cancelUrl) {
+      this.app.throw(422, 'PayPal payment requires return and cancel URLs');
+    }
+    const orders = new OrdersController(this._createClient(clientOptions));
+    const response = await orders.createOrder({
+      paypalRequestId: input.idempotencyKey,
+      body: {
+        intent: CheckoutPaymentIntent.Capture,
+        applicationContext: { returnUrl: input.returnUrl, cancelUrl: input.cancelUrl },
+        purchaseUnits: [
+          {
+            customId: String(input.paymentSessionId),
+            invoiceId: input.businessReference,
+            amount: {
+              currencyCode: input.currency,
+              value: formatMinorAmount(input.amountMinor, input.currency),
+            },
+          },
+        ],
+      },
+    } as never);
+    const order = response.result;
+    const approvalUrl = order?.links?.find(item => item.rel === 'approve')?.href;
+    if (!order?.id || !approvalUrl) this.app.throw(502, 'PayPal did not return an approval order');
+    return {
+      state: 'requires_action',
+      providerPaymentId: order.id,
+      providerOrderId: order.id,
+      nextAction: { kind: 'redirect', url: approvalUrl },
+    };
   }
 
   async queryPayment(
-    _input: IPayProviderPaymentInput,
-    _clientOptions: IPayProviderPaypalClientOptions,
+    input: IPayProviderPaymentInput,
+    clientOptions: IPayProviderPaypalClientOptions,
   ): Promise<IPayProviderPaymentSnapshot> {
-    this.app.throw(501, 'PayPal provider is not configured');
+    if (!input.providerOrderId) return { state: 'requires_action' };
+    const orders = new OrdersController(this._createClient(clientOptions));
+    const response = await orders.getOrder({ id: input.providerOrderId });
+    const order = response.result;
+    if (!order?.id) this.app.throw(502, 'PayPal order query returned no order');
+    const capture = order.purchaseUnits?.[0]?.payments?.captures?.[0];
+    if (capture?.status === 'COMPLETED') {
+      return {
+        state: 'succeeded',
+        providerPaymentId: order.id,
+        providerOrderId: order.id,
+        providerCaptureId: capture.id,
+        nextAction: { kind: 'completed' },
+      };
+    }
+    if (capture?.status === 'FAILED' || capture?.status === 'DECLINED') {
+      return { state: 'failed', providerPaymentId: order.id, providerOrderId: order.id };
+    }
+    if (order.status === OrderStatus.Voided) {
+      return { state: 'cancelled', providerPaymentId: order.id, providerOrderId: order.id };
+    }
+    if (capture?.status === 'PENDING') {
+      return { state: 'processing', providerPaymentId: order.id, providerOrderId: order.id };
+    }
+    return { state: 'requires_action', providerPaymentId: order.id, providerOrderId: order.id };
   }
 
   async createRefund(
+    input: IPayProviderRefundInput,
+    clientOptions: IPayProviderPaypalClientOptions,
+  ): Promise<IPayProviderRefundSnapshot> {
+    const payments = new PaymentsController(this._createClient(clientOptions));
+    const response = await payments.refundCapturedPayment({
+      captureId: input.providerCaptureId,
+      paypalRequestId: input.idempotencyKey,
+      body: {
+        amount: {
+          currencyCode: input.currency,
+          value: formatMinorAmount(input.amountMinor, input.currency),
+        },
+      },
+    } as never);
+    return mapRefund(response.result?.status, response.result?.id);
+  }
+
+  async queryRefund(
     _input: IPayProviderRefundInput,
     _clientOptions: IPayProviderPaypalClientOptions,
   ): Promise<IPayProviderRefundSnapshot> {
-    this.app.throw(501, 'PayPal provider is not configured');
+    this.app.throw(501, 'PayPal refund query requires a persisted provider refund identifier');
   }
 
   async verifyWebhook(
     _input: IPayProviderWebhookInput,
     _clientOptions: IPayProviderPaypalClientOptions,
   ): Promise<IPayProviderVerifiedWebhook> {
-    this.app.throw(501, 'PayPal webhook verification is not configured');
+    this.app.throw(501, 'PayPal webhook verification requires configured webhook verification');
   }
+
+  private _createClient(clientOptions: IPayProviderPaypalClientOptions) {
+    const { clientId, clientSecret } = clientOptions.secretCredential;
+    if (!clientId || !clientSecret)
+      this.app.throw(503, 'PayPal client credentials are not configured');
+    return new Client({
+      clientCredentialsAuthCredentials: {
+        oAuthClientId: clientId,
+        oAuthClientSecret: clientSecret,
+      },
+      timeout: 0,
+      environment:
+        clientOptions.environment === 'live' ? Environment.Production : Environment.Sandbox,
+    });
+  }
+}
+
+function formatMinorAmount(amountMinor: number, currency: string) {
+  if (!Number.isSafeInteger(amountMinor) || amountMinor < 0 || currency !== 'USD') {
+    throw new Error('PayPal supports only nonnegative USD minor-unit amounts');
+  }
+  return `${Math.floor(amountMinor / 100)}.${String(amountMinor % 100).padStart(2, '0')}`;
+}
+
+function mapRefund(status?: string, providerRefundId?: string): IPayProviderRefundSnapshot {
+  if (status === 'COMPLETED') return { state: 'succeeded', providerRefundId };
+  if (status === 'FAILED') return { state: 'failed', providerRefundId };
+  if (status === 'CANCELLED') return { state: 'cancelled', providerRefundId };
+  return { state: 'pending', providerRefundId };
 }
 
 declare module 'vona-module-a-pay' {