שילוב שער תשלום מותאם אישית עבור Medusa.js

import { AbstractPaymentProvider, PaymentProviderError, PaymentProviderSessionResponse, PaymentSessionStatus, CreatePaymentProviderSession, UpdatePaymentProviderSession, } from '@medusajs/framework/utils'; class MyPayProvider extends AbstractPaymentProvider<MyPayOptions> { static identifier = 'mypay'; private client: MyPayClient; constructor(container: unknown, options: MyPayOptions) { super(container, options); this.client = new MyPayClient(options.apiKey, options.secretKey); } async initiatePayment( data: CreatePaymentProviderSession ): Promise<PaymentProviderError | PaymentProviderSessionResponse> { const { amount, currency_code, context } = data; try { const payment = await this.client.createPayment({ amount: Math.round(amount), currency: currency_code.toUpperCase(), order_id: context.cart_id, email: context.customer?.email, callback_url: `${process.env.BACKEND_URL}/mypay/webhook`, }); return { id: payment.id, data: { payment_id: payment.id, payment_url: payment.checkout_url, status: payment.status, }, }; } catch (e) { return { error: e.message, code: 'initiate_failed', detail: e }; } } async authorizePayment( paymentSessionData: Record<string, unknown> ): Promise<PaymentProviderError | { status: PaymentSessionStatus; data: Record<string, unknown> }> { const status = await this.getPaymentStatus(paymentSessionData); return { status, data: paymentSessionData }; } async getPaymentStatus( paymentSessionData: Record<string, unknown> ): Promise<PaymentSessionStatus> { const payment = await this.client.getPayment(paymentSessionData.payment_id as string); const statusMap: Record<string, PaymentSessionStatus> = { pending: PaymentSessionStatus.PENDING, succeeded: PaymentSessionStatus.AUTHORIZED, failed: PaymentSessionStatus.ERROR, cancelled: PaymentSessionStatus.CANCELED, }; return statusMap[payment.status] ?? PaymentSessionStatus.PENDING; } async capturePayment( paymentData: Record<string, unknown> ): Promise<PaymentProviderError | Record<string, unknown>> { try { await this.client.capture(paymentData.payment_id as string); return { ...paymentData, status: 'captured' }; } catch (e) { return { error: e.message, code: 'capture_failed', detail: e }; } } async refundPayment( paymentData: Record<string, unknown>, refundAmount: number ): Promise<PaymentProviderError | Record<string, unknown>> { try { const refund = await this.client.refund( paymentData.payment_id as string, Math.round(refundAmount) ); return { ...paymentData, refund_id: refund.id }; } catch (e) { return { error: e.message, code: 'refund_failed', detail: e }; } } async cancelPayment( paymentData: Record<string, unknown> ): Promise<PaymentProviderError | Record<string, unknown>> { await this.client.cancel(paymentData.payment_id as string); return { ...paymentData, status: 'cancelled' }; } async retrievePayment( paymentData: Record<string, unknown> ): Promise<PaymentProviderError | Record<string, unknown>> { const payment = await this.client.getPayment(paymentData.payment_id as string); return { ...paymentData, ...payment }; } } export default MyPayProvider; 

שלב 2: רשום את הספק בתצורה.

// medusa-config.ts module.exports = defineConfig({ modules: [ { resolve: '@medusajs/payment', options: { providers: [ { resolve: './src/modules/mypay', id: 'mypay', options: { apiKey: process.env.MYPAY_API_KEY, secretKey: process.env.MYPAY_SECRET_KEY, }, }, ], }, }, ], }); 

שלב 3: הגדר handler ל-webhook.

// src/api/mypay/webhook/route.ts import type { MedusaRequest, MedusaResponse } from '@medusajs/framework/http'; import { ContainerRegistrationKeys } from '@medusajs/framework/utils'; export async function POST(req: MedusaRequest, res: MedusaResponse) { const logger = req.scope.resolve(ContainerRegistrationKeys.LOGGER); const signature = req.headers['x-signature'] as string; const isValid = verifySignature(JSON.stringify(req.body), signature, process.env.MYPAY_SECRET_KEY!); if (!isValid) { return res.status(403).json({ message: 'Invalid signature' }); } const { payment_id, status } = req.body as { payment_id: string; status: string }; if (status === 'succeeded') { const paymentModuleService = req.scope.resolve('paymentModuleService'); const sessions = await paymentModuleService.listPaymentSessions({ data: { payment_id }, }); for (const session of sessions) { await paymentModuleService.authorizePaymentSession(session.id, req.body); } } res.status(200).json({ received: true }); } 

ספק Stripe הרשמי

עבור Stripe קיים payment_id רשמי:

npm install @medusajs/payment-stripe 

// medusa-config.ts { resolve: '@medusajs/payment-stripe', options: { apiKey: process.env.STRIPE_API_KEY, webhookSecret: process.env.STRIPE_WEBHOOK_SECRET, capture: true, // автоматический capture }, } 

הספק הרשמי תומך ב-webhooks של Stripe, 3DS, החזרים כספיים ו-Stripe Connect מובנים. אך אם אתה צריך לוגיקה מותאמת אישית — ספק מותאם אישית נותן יותר שליטה. ראה את התיעוד הרשמי לפרטים נוספים.

שלבי אינטגרציה

אנו מבצעים אינטגרציה סוהר:

• פיתוח או הגדרה של ספק מותאם אישית.
• הוספת נקודות קצה ל-webhook עם אימות חתימה.
• בדיקת תרחישים: תשלום מוצלח, ביטול, החזר כספי.
• תיעוד ארכיטקטורה ותצורה.
• הדרכת צוות (1-2 שעות).
• תמיכה לאחר השקה (שבועיים).

תוצרים הכלולים בשירות שלנו

• קוד מקור מלא עם הערות.
• הוראות פריסה ורשימת משתני סביבה.
• תיעוד API לנקודות קצה מותאמות אישית.
• גישה לסביבת בדיקה עם עסקאות לדוגמה.
• שעתיים של הדרכה לצוות הפיתוח.
• שבועיים של תמיכה לאחר השקה עם מענה חירום 24/7.

קבלו ייעוץ למקרה שלכם — פשוט כתבו לנו. הניסיון שלנו — 50+ אינטגרציות. הצוות שלנו מוסמך Medusa, ואנו מבטיחים אינטגרציה מוצלחת. צרו קשר כדי שנוכל להעריך את הפרויקט שלכם — נשלח לוחות זמנים והצעה מסחרית תוך יום.

תהליך האינטגרציה ולוח הזמנים

לוח זמנים כולל — בין 5 ל-10 ימי עסקים בהתאם למורכבות. העלות קבועה לאחר הניתוח.