ZarinpalAdapter

تنها درگاه کاملاً پیاده‌سازی‌شده که با REST API نسخه ۴ زرین‌پال صحبت می‌کند. هم‌زمان مرجعی برای شکل درست یک آداپتور است.

export class ZarinpalAdapter implements GatewayAdapter {
  constructor(config: ZarinpalConfig);
  createPayment(request: PaymentRequest): Promise<PaymentResult>;
  verifyCallback(request: CallbackRequest): Promise<VerificationResult>;
}

اندپوینت‌ها

• POST {baseUrl}/v4/payment/request.json — متد createPayment. بدنه شامل merchant_id، amount که از قبل به ریال است، description، callback_url و کل آبجکت metadata است.
• POST {baseUrl}/v4/payment/verify.json — متد verifyCallback. بدنه شامل merchant_id، amount تبدیل‌شده با toRials و authority است.

فیلدها

خطاها

• PaymentValidationError — از سازنده وقتی merchantId فalsy باشد، و از verifyCallback وقتی Authority یا مبلغ عددی غایب باشد.
• GatewayProviderError — از createPayment وقتی کد پاسخ درخواست ۱۰۰ نباشد. کل پاسخ به‌عنوان cause پیوست می‌شود.
• GatewayNetworkError — از کمکی تابع request هنگام رد شدن fetch یا خاتمه ۱۰ ثانیه‌ای.

نمونه کد

import { UnoPay, ZarinpalAdapter } from 'unopay';

const unopay = new UnoPay({
  zarinpal: new ZarinpalAdapter({
    merchantId: process.env.ZARINPAL_MERCHANT_ID!,
    sandbox: true,
  }),
});

const payment = await unopay.createPayment('zarinpal', {
  amount: 50000,
  currency: 'IRT',
  callbackUrl: 'https://yoursite.com/api/payment/callback',
  metadata: { description: 'Order #1024' },
});

return Response.redirect(payment.redirectUrl, 302);

پیکربندی ZarinpalAdapter. سه فیلد، که تنها یکی از آن‌ها الزامی است.

export interface ZarinpalConfig {
  merchantId: string;
  sandbox?: boolean;
  logger?: PaymentLogger;
}

فیلدها

نمونه کد

const adapter = new ZarinpalAdapter({
  merchantId: process.env.ZARINPAL_MERCHANT_ID!,
  sandbox: process.env.NODE_ENV !== 'production',
});