@crediblemark/buayar 0.2.0 → 0.3.0

package/README.md

@@ -85,6 +85,13 @@
   * Verifikasi Header & Webhook otomatis.
   * Ekstensi `OyClient` (Inquiry Status, Saldo Merchant & Kirim Uang/Disbursement).
 
+* 🏛️ **[Integrasi Stripe (docs/stripe.md)](file:///media/rasyiqi/7653717A1C07B131/Buayar/docs/stripe.md)**
+  * Checkout Sessions API (Redirect Hosted Page, multi-currency).
+  * Payment Intents API Direct Charge (Kartu Kredit, Debit, Google Pay, Apple Pay, dll).
+  * Verifikasi webhook signature HMAC-SHA256 otomatis.
+  * Ekstensi `StripeClient` (Retrieve Session, Retrieve Intent, Refund, Saldo Merchant).
+  * ⚠️ **Catatan**: Stripe tidak mendukung Virtual Account lokal Indonesia. Cocok untuk pembayaran internasional / kartu kredit global.
+
 ---
 
 ## ⚙️ Konfigurasi Environment Variables (`.env`)
@@ -93,8 +100,8 @@ SDK `Buayar` membaca konfigurasi secara otomatis dari `process.env`. Anda dapat
 
 ### 1. Standar Universal (Direkomendasikan)
 ```env
-# Provider aktif: 'midtrans' | 'duitku' | 'ipaymu' | 'xendit' | 'doku' | 'prismalink' | 'faspay' | 'finpay' | 'nicepay' | 'oy'
-PROVIDER_PG=oy
+# Provider aktif: 'midtrans' | 'duitku' | 'ipaymu' | 'xendit' | 'doku' | 'prismalink' | 'faspay' | 'finpay' | 'nicepay' | 'oy' | 'stripe'
+PROVIDER_PG=stripe
 
 # Kredensial Universal
 BUAYAR_MERCHANT_CODE=myusername # Username OY! Bisnis
@@ -136,6 +143,9 @@ BUAYAR_RETURN_URL=https://myapp.com/payment/finish
 | `NICEPAY_KEY` | Nicepay | Merchant Key rahasia Nicepay. |
 | `OY_USERNAME` | OY! Bisnis | Username akun OY! Bisnis. |
 | `OY_API_KEY` | OY! Bisnis | API Key OY! Bisnis. |
+| `STRIPE_SECRET_KEY` | Stripe | Secret Key Stripe (`sk_test_...` / `sk_live_...`). **Wajib.** |
+| `STRIPE_WEBHOOK_SECRET` | Stripe | Webhook Signing Secret Stripe (`whsec_...`). Wajib untuk verifikasi callback. |
+| `STRIPE_PUBLIC_KEY` | Stripe | Publishable Key Stripe (`pk_test_...` / `pk_live_...`). Opsional, untuk frontend. |
 | `BUAYAR_API_KEY` / `PG_API_KEY` / `PAYMENT_API_KEY` | Semua | API Key / Server Key universal. |
 | `BUAYAR_MERCHANT_CODE` / `PG_MERCHANT_CODE` | Duitku / Umum | Kode merchant dari dashboard payment gateway. |
 | `BUAYAR_SANDBOX` / `PG_SANDBOX` / `PAYMENT_SANDBOX` | Semua | Mode sandbox (`true` / `false`). |

package/dist/index.d.mts

@@ -19,6 +19,11 @@ interface CreateInvoiceParams {
      * Jika dikosongkan, akan beralih ke Mode Semi Integrasi (Redirect Checkout).
      */
     paymentMethod?: CanonicalPaymentMethod | string;
+    /**
+     * Kode mata uang ISO 4217 (opsional). Default: 'IDR'.
+     * Contoh: 'idr', 'usd', 'sgd'
+     */
+    currency?: string;
     /** Parameter kustom tambahan untuk provider spesifik (opsional) */
     providerParams?: any;
 }
@@ -335,6 +340,96 @@ declare class OyProvider extends BasePaymentProvider {
     checkTransaction(params: CheckTransactionParams, config: ProviderConfig): Promise<CheckTransactionResult>;
 }
 
+declare class StripeProvider extends BasePaymentProvider {
+    readonly name = "stripe";
+    private getBaseUrl;
+    createInvoice(params: CreateInvoiceParams, config: ProviderConfig): Promise<InvoiceResponse>;
+    verifyCallback(body: any, config: ProviderConfig): Promise<VerifyCallbackResult>;
+    getPaymentMethods(params: GetPaymentMethodsParams, config: ProviderConfig): Promise<GetPaymentMethodsResult>;
+    checkTransaction(params: CheckTransactionParams, config: ProviderConfig): Promise<CheckTransactionResult>;
+}
+
+declare class PaypalProvider extends BasePaymentProvider {
+    readonly name = "paypal";
+    private getSandbox;
+    private getBaseUrl;
+    /** OAuth2 Client Credentials — dapatkan access token */
+    private getAccessToken;
+    createInvoice(params: CreateInvoiceParams, config: ProviderConfig): Promise<InvoiceResponse>;
+    verifyCallback(body: any, config: ProviderConfig): Promise<VerifyCallbackResult>;
+    getPaymentMethods(params: GetPaymentMethodsParams, config: ProviderConfig): Promise<GetPaymentMethodsResult>;
+    checkTransaction(params: CheckTransactionParams, config: ProviderConfig): Promise<CheckTransactionResult>;
+}
+
+declare class AdyenProvider extends BasePaymentProvider {
+    readonly name = "adyen";
+    private getBaseUrl;
+    createInvoice(params: CreateInvoiceParams, config: ProviderConfig): Promise<InvoiceResponse>;
+    verifyCallback(body: any, config: ProviderConfig): Promise<VerifyCallbackResult>;
+    getPaymentMethods(params: GetPaymentMethodsParams, config: ProviderConfig): Promise<GetPaymentMethodsResult>;
+    checkTransaction(params: CheckTransactionParams, config: ProviderConfig): Promise<CheckTransactionResult>;
+}
+
+declare class CheckoutComProvider extends BasePaymentProvider {
+    readonly name = "checkoutcom";
+    private getBaseUrl;
+    createInvoice(params: CreateInvoiceParams, config: ProviderConfig): Promise<InvoiceResponse>;
+    verifyCallback(body: any, config: ProviderConfig): Promise<VerifyCallbackResult>;
+    getPaymentMethods(params: GetPaymentMethodsParams, config: ProviderConfig): Promise<GetPaymentMethodsResult>;
+    checkTransaction(params: CheckTransactionParams, config: ProviderConfig): Promise<CheckTransactionResult>;
+}
+
+declare class RazorpayProvider extends BasePaymentProvider {
+    readonly name = "razorpay";
+    private getBaseUrl;
+    private buildHeaders;
+    createInvoice(params: CreateInvoiceParams, config: ProviderConfig): Promise<InvoiceResponse>;
+    verifyCallback(body: any, config: ProviderConfig): Promise<VerifyCallbackResult>;
+    getPaymentMethods(params: GetPaymentMethodsParams, config: ProviderConfig): Promise<GetPaymentMethodsResult>;
+    checkTransaction(params: CheckTransactionParams, config: ProviderConfig): Promise<CheckTransactionResult>;
+}
+
+declare class SquareProvider extends BasePaymentProvider {
+    readonly name = "square";
+    private getBaseUrl;
+    private buildHeaders;
+    createInvoice(params: CreateInvoiceParams, config: ProviderConfig): Promise<InvoiceResponse>;
+    verifyCallback(body: any, config: ProviderConfig): Promise<VerifyCallbackResult>;
+    getPaymentMethods(params: GetPaymentMethodsParams, config: ProviderConfig): Promise<GetPaymentMethodsResult>;
+    checkTransaction(params: CheckTransactionParams, config: ProviderConfig): Promise<CheckTransactionResult>;
+}
+
+declare class PayuProvider extends BasePaymentProvider {
+    readonly name = "payu";
+    private getBaseUrl;
+    /** OAuth2 Bearer Token untuk PayU */
+    private getAccessToken;
+    createInvoice(params: CreateInvoiceParams, config: ProviderConfig): Promise<InvoiceResponse>;
+    verifyCallback(body: any, config: ProviderConfig): Promise<VerifyCallbackResult>;
+    getPaymentMethods(params: GetPaymentMethodsParams, config: ProviderConfig): Promise<GetPaymentMethodsResult>;
+    checkTransaction(params: CheckTransactionParams, config: ProviderConfig): Promise<CheckTransactionResult>;
+}
+
+declare class BraintreeProvider extends BasePaymentProvider {
+    readonly name = "braintree";
+    private getBaseUrl;
+    private buildHeaders;
+    createInvoice(params: CreateInvoiceParams, config: ProviderConfig): Promise<InvoiceResponse>;
+    verifyCallback(body: any, config: ProviderConfig): Promise<VerifyCallbackResult>;
+    getPaymentMethods(params: GetPaymentMethodsParams, config: ProviderConfig): Promise<GetPaymentMethodsResult>;
+    checkTransaction(params: CheckTransactionParams, config: ProviderConfig): Promise<CheckTransactionResult>;
+}
+
+declare class TwoCheckoutProvider extends BasePaymentProvider {
+    readonly name = "twocheckout";
+    private getBaseUrl;
+    private buildHeaders;
+    createInvoice(params: CreateInvoiceParams, config: ProviderConfig): Promise<InvoiceResponse>;
+    verifyCallback(body: any, config: ProviderConfig): Promise<VerifyCallbackResult>;
+    getPaymentMethods(params: GetPaymentMethodsParams, config: ProviderConfig): Promise<GetPaymentMethodsResult>;
+    checkTransaction(params: CheckTransactionParams, config: ProviderConfig): Promise<CheckTransactionResult>;
+}
+
 interface DuitkuDisbursementParams {
     bankCode: string;
     bankAccount: string;
@@ -628,6 +723,165 @@ declare class OyClient {
     }): Promise<any>;
 }
 
+declare class StripeClient {
+    private secretKey;
+    constructor(config: ProviderConfig | {
+        apiKey?: string;
+        serverKey?: string;
+        secretKey?: string;
+    });
+    private getBaseUrl;
+    /**
+     * Helper HTTP Request ke Stripe API
+     */
+    request(method: "GET" | "POST" | "DELETE", endpoint: string, body?: any): Promise<any>;
+    /**
+     * Ambil detail Checkout Session
+     */
+    retrieveCheckoutSession(sessionId: string): Promise<any>;
+    /**
+     * Ambil detail Payment Intent
+     */
+    retrievePaymentIntent(paymentIntentId: string): Promise<any>;
+    /**
+     * Cek saldo akun Stripe (Balance)
+     */
+    checkBalance(): Promise<any>;
+    /**
+     * Buat refund dana
+     */
+    createRefund(paymentIntentId: string, amount?: number): Promise<any>;
+}
+
+declare class PaypalClient {
+    private config;
+    constructor(config: ProviderConfig);
+    private getBaseUrl;
+    private getAccessToken;
+    /** Ambil detail order PayPal berdasarkan Order ID */
+    getOrder(orderId: string): Promise<any>;
+    /** Capture order PayPal (mengeksekusi pembayaran yang sudah diapprove buyer) */
+    captureOrder(orderId: string): Promise<any>;
+    /** Refund capture PayPal */
+    refundCapture(captureId: string, amount?: number, currency?: string): Promise<any>;
+    /** Cek saldo akun PayPal merchant (hanya tersedia di account via Seller REST API) */
+    checkBalance(): Promise<any>;
+    /** Verifikasi webhook via PayPal Webhook Verification API */
+    verifyWebhookSignature(webhookId: string, body: any, headers: Record<string, string>): Promise<boolean>;
+}
+
+declare class AdyenClient {
+    private config;
+    constructor(config: ProviderConfig);
+    private getBaseUrl;
+    private buildHeaders;
+    /** Ambil detail payment berdasarkan PSP Reference */
+    getPaymentDetails(pspReference: string): Promise<any>;
+    /** Batalkan payment (sebelum capture) */
+    cancelPayment(pspReference: string, merchantAccount?: string): Promise<any>;
+    /** Refund payment yang sudah di-capture */
+    refundPayment(pspReference: string, amount: number, currency: string, merchantAccount?: string): Promise<any>;
+    /** Capture authorized payment */
+    capturePayment(pspReference: string, amount: number, currency: string, merchantAccount?: string): Promise<any>;
+    /** Ambil daftar payment methods yang tersedia */
+    getAvailablePaymentMethods(merchantAccount: string, countryCode: string, currency: string, amount: number): Promise<any>;
+}
+
+declare class CheckoutComClient {
+    private config;
+    constructor(config: ProviderConfig);
+    private getBaseUrl;
+    private buildHeaders;
+    /** Ambil detail payment berdasarkan Payment ID */
+    getPaymentDetails(paymentId: string): Promise<any>;
+    /** Void (batalkan) payment yang belum di-capture */
+    voidPayment(paymentId: string, reference?: string): Promise<any>;
+    /** Refund payment yang sudah di-capture */
+    refundPayment(paymentId: string, amount?: number, reference?: string): Promise<any>;
+    /** Cek saldo merchant di Checkout.com */
+    checkBalance(): Promise<any>;
+    /** Ambil daftar payment links */
+    listPaymentLinks(): Promise<any>;
+}
+
+declare class RazorpayClient {
+    private config;
+    constructor(config: ProviderConfig);
+    private getBaseUrl;
+    private buildHeaders;
+    /** Ambil detail payment */
+    fetchPayment(paymentId: string): Promise<any>;
+    /** Capture authorized payment */
+    capturePayment(paymentId: string, amount: number, currency?: string): Promise<any>;
+    /** Buat refund untuk payment */
+    createRefund(paymentId: string, amount?: number, notes?: Record<string, string>): Promise<any>;
+    /** Cek saldo akun Razorpay */
+    checkBalance(): Promise<any>;
+    /** Ambil daftar semua payment */
+    listPayments(from?: number, to?: number, count?: number): Promise<any>;
+}
+
+declare class SquareClient {
+    private config;
+    constructor(config: ProviderConfig);
+    private getBaseUrl;
+    private buildHeaders;
+    /** Ambil detail payment Square */
+    getPayment(paymentId: string): Promise<any>;
+    /** Batalkan payment Square */
+    cancelPayment(paymentId: string): Promise<any>;
+    /** Refund payment Square */
+    refundPayment(paymentId: string, amount: number, currency: string, idempotencyKey: string, reason?: string): Promise<any>;
+    /** Ambil saldo location Square */
+    retrieveBalance(locationId?: string): Promise<any>;
+    /** List semua locations merchant */
+    listLocations(): Promise<any>;
+}
+
+declare class PayuClient {
+    private config;
+    private accessToken;
+    constructor(config: ProviderConfig);
+    private getBaseUrl;
+    private getToken;
+    /** Ambil detail order PayU */
+    getOrder(orderId: string): Promise<any>;
+    /** Batalkan order PayU */
+    cancelOrder(orderId: string): Promise<any>;
+    /** Refund order PayU */
+    refundOrder(orderId: string, amount?: number, description?: string): Promise<any>;
+}
+
+declare class BraintreeClient {
+    private config;
+    constructor(config: ProviderConfig);
+    private getBaseUrl;
+    private buildHeaders;
+    /** Generate Client Token untuk frontend Drop-in UI */
+    getClientToken(customerId?: string): Promise<string>;
+    /** Ambil detail transaction */
+    findTransaction(transactionId: string): Promise<any>;
+    /** Refund transaction Braintree */
+    refundTransaction(transactionId: string, amount?: number): Promise<any>;
+    /** Void (batalkan) transaction sebelum settlement */
+    voidTransaction(transactionId: string): Promise<any>;
+}
+
+declare class TwoCheckoutClient {
+    private config;
+    constructor(config: ProviderConfig);
+    private getBaseUrl;
+    private buildHeaders;
+    /** Ambil detail order 2Checkout berdasarkan Reference Number */
+    getOrder(refNo: string): Promise<any>;
+    /** Refund order 2Checkout */
+    refundOrder(refNo: string, amount: number, comment?: string): Promise<any>;
+    /** Ambil detail subscription */
+    getSubscription(subscriptionRef: string): Promise<any>;
+    /** List semua orders merchant */
+    listOrders(page?: number, limit?: number): Promise<any>;
+}
+
 declare class PaymentManager {
     private providers;
     constructor();
@@ -653,6 +907,24 @@ declare class PaymentManager {
     getNicepayClient(config: ProviderConfig): NicepayClient;
     getOyProvider(): OyProvider;
     getOyClient(config: ProviderConfig): OyClient;
+    getStripeProvider(): StripeProvider;
+    getStripeClient(config: ProviderConfig): StripeClient;
+    getPaypalProvider(): PaypalProvider;
+    getPaypalClient(config: ProviderConfig): PaypalClient;
+    getAdyenProvider(): AdyenProvider;
+    getAdyenClient(config: ProviderConfig): AdyenClient;
+    getCheckoutComProvider(): CheckoutComProvider;
+    getCheckoutComClient(config: ProviderConfig): CheckoutComClient;
+    getRazorpayProvider(): RazorpayProvider;
+    getRazorpayClient(config: ProviderConfig): RazorpayClient;
+    getSquareProvider(): SquareProvider;
+    getSquareClient(config: ProviderConfig): SquareClient;
+    getPayuProvider(): PayuProvider;
+    getPayuClient(config: ProviderConfig): PayuClient;
+    getBraintreeProvider(): BraintreeProvider;
+    getBraintreeClient(config: ProviderConfig): BraintreeClient;
+    getTwoCheckoutProvider(): TwoCheckoutProvider;
+    getTwoCheckoutClient(config: ProviderConfig): TwoCheckoutClient;
     createInvoice(providerName: string, params: CreateInvoiceParams, config: ProviderConfig): Promise<InvoiceResponse>;
     verifyCallback(providerName: string, body: any, config: ProviderConfig): Promise<VerifyCallbackResult>;
     getPaymentMethods(providerName: string, params: GetPaymentMethodsParams, config: ProviderConfig): Promise<GetPaymentMethodsResult>;
@@ -676,6 +948,10 @@ declare function resolveConfigFromEnv(customConfig?: BuayarConfig): BuayarConfig
  *
  * Antarmuka tingkat tinggi untuk membuat transaksi, query channel pembayaran,
  * pengecekan status, dan verifikasi webhook universal tanpa perlu rombak kode.
+ *
+ * Mendukung 19 Payment Gateway: Midtrans, Duitku, iPaymu, Xendit, DOKU, PrismaLink,
+ * Faspay, Finpay, Nicepay, OY! Bisnis, Stripe, PayPal, Adyen, Checkout.com,
+ * Razorpay, Square, PayU, Braintree, 2Checkout/Verifone.
  */
 declare class Buayar {
     private manager;
@@ -690,7 +966,7 @@ declare class Buayar {
      */
     setConfig(config: Partial<BuayarConfig>): void;
     /**
-     * Dapatkan nama provider aktif ('midtrans' | 'duitku' | 'ipaymu' | 'xendit' | 'doku' | 'prismalink' | 'faspay' | 'finpay' | 'nicepay' | 'oy' | ...)
+     * Dapatkan nama provider aktif
      */
     get provider(): string;
     /**
@@ -730,6 +1006,15 @@ declare class Buayar {
     getFinpayClient(configOverride?: Partial<ProviderConfig>): FinpayClient;
     getNicepayClient(configOverride?: Partial<ProviderConfig>): NicepayClient;
     getOyClient(configOverride?: Partial<ProviderConfig>): OyClient;
+    getStripeClient(configOverride?: Partial<ProviderConfig>): StripeClient;
+    getPaypalClient(configOverride?: Partial<ProviderConfig>): PaypalClient;
+    getAdyenClient(configOverride?: Partial<ProviderConfig>): AdyenClient;
+    getCheckoutComClient(configOverride?: Partial<ProviderConfig>): CheckoutComClient;
+    getRazorpayClient(configOverride?: Partial<ProviderConfig>): RazorpayClient;
+    getSquareClient(configOverride?: Partial<ProviderConfig>): SquareClient;
+    getPayuClient(configOverride?: Partial<ProviderConfig>): PayuClient;
+    getBraintreeClient(configOverride?: Partial<ProviderConfig>): BraintreeClient;
+    getTwoCheckoutClient(configOverride?: Partial<ProviderConfig>): TwoCheckoutClient;
 }
 declare const buayar: Buayar;
 
@@ -798,6 +1083,10 @@ declare const CANONICAL_TO_OY: Record<string, {
     bank_code?: string;
     channel?: string;
 }>;
+/**
+ * Mapping dari Canonical Payment Method ke payment_method_types Stripe
+ */
+declare const CANONICAL_TO_STRIPE: Record<string, string>;
 /**
  * Ubah method code apapun (baik canonical maupun kode raw provider) ke kode Duitku yang valid
  */
@@ -852,6 +1141,10 @@ declare function toOyPaymentMethod(code?: string): {
     bank_code?: string;
     channel?: string;
 } | undefined;
+/**
+ * Ubah method code apapun ke format Stripe
+ */
+declare function toStripePaymentMethod(code?: string): string | undefined;
 /**
  * Ubah method code apapun ke format canonical standar Buayar
  */
@@ -979,6 +1272,94 @@ declare function generateOyHeaders(username: string, apiKey: string): Record<str
  */
 declare function verifyOyWebhook(headers: Record<string, string | string[] | undefined>, expectedUsername: string): boolean;
 
+/**
+ * Serializer helper untuk format URL-encoded form data Stripe
+ * Mendukung nested object dan array seperti line_items[0][price_data][unit_amount]
+ */
+declare function serializeStripeParams(obj: any, prefix?: string): string;
+/**
+ * Verifikasi webhook signature Stripe (stripe-signature header)
+ * Format header: t=1492774577,v1=5257a869e7ecebeda32affa62cd323fa9d214e1b50613e039f08f6362ced773d
+ */
+declare function verifyStripeWebhook(rawPayload: string | any, signatureHeader: string, webhookSecret: string, toleranceSeconds?: number): boolean;
+
+/**
+ * Encode Basic Auth untuk PayPal REST API (client_id:client_secret)
+ */
+declare function buildPaypalBasicAuth(clientId: string, clientSecret: string): string;
+/**
+ * Verifikasi PayPal webhook signature (simplified HMAC via transmission-sig header).
+ * Full cert-chain verification tersedia via POST /v1/notifications/verify-webhook-signature.
+ */
+declare function verifyPaypalWebhookSimple(transmissionId: string, timestamp: string, webhookId: string, body: string, transmissionSig: string, certUrl: string): boolean;
+/**
+ * Serialize object ke URL-encoded query string (shallow)
+ */
+declare function serializePaypalParams(obj: Record<string, any>): string;
+
+/**
+ * Verifikasi Adyen webhook signature (HMAC-SHA256).
+ * Adyen menggunakan sorted key-value string dari notification item.
+ */
+declare function verifyAdyenWebhook(notificationItem: any, hmacKey: string): boolean;
+
+/**
+ * Verifikasi Checkout.com webhook signature (HMAC-SHA256).
+ * Header: Cko-Signature: sha256=<hex_digest>
+ */
+declare function verifyCheckoutComWebhook(body: string, signatureHeader: string, secret: string): boolean;
+
+/**
+ * Verifikasi Razorpay webhook signature (HMAC-SHA256).
+ * Header: X-Razorpay-Signature
+ */
+declare function verifyRazorpayWebhook(rawBody: string, signature: string, webhookSecret: string): boolean;
+/**
+ * Buat Basic Auth header untuk Razorpay (key_id:key_secret)
+ */
+declare function buildRazorpayBasicAuth(keyId: string, keySecret: string): string;
+
+/**
+ * Verifikasi Square webhook signature (HMAC-SHA256).
+ * Header: x-square-hmacsha256-signature
+ * Signature = Base64(HMAC-SHA256(signatureKey, notificationUrl + body))
+ */
+declare function verifySquareWebhook(rawBody: string, signatureHeader: string, signatureKey: string, notificationUrl: string): boolean;
+
+/**
+ * Verifikasi PayU webhook signature (MD5 atau SHA-256 dari OpenPayU-Signature header).
+ * Format header: sender=checkout;signature=<md5_hash>;algorithm=MD5;version=2.1
+ */
+declare function verifyPayuWebhook(rawBody: string, signatureHeader: string, md5Key: string): boolean;
+/**
+ * Build Basic Auth untuk PayU Token endpoint
+ */
+declare function buildPayuBasicAuth(clientId: string, clientSecret: string): string;
+
+/**
+ * Verifikasi Braintree webhook signature (SHA1 HMAC dari bt_payload).
+ * Header contains: bt_signature=public_key|sha1_hmac & bt_payload=base64_encoded
+ */
+declare function verifyBraintreeWebhook(btSignature: string, btPayload: string, privateKey: string): boolean;
+/**
+ * Build Basic Auth untuk Braintree API (public_key:private_key)
+ */
+declare function buildBraintreeBasicAuth(publicKey: string, privateKey: string): string;
+
+/**
+ * Build 2Checkout API Authentication header.
+ * Format: code=MERCHANT_CODE date=DATE hash=HMAC-SHA256(MERCHANT_CODE + date + secretKey)
+ */
+declare function buildTwoCheckoutAuth(merchantCode: string, secretKey: string): {
+    header: string;
+    date: string;
+};
+/**
+ * Verifikasi 2Checkout IPN/webhook (MD5 hash).
+ * hash = MD5(secretWord + saleId + productId + invoiceId)
+ */
+declare function verifyTwoCheckoutWebhook(secretWord: string, saleId: string, productId: string, invoiceId: string, providedHash: string): boolean;
+
 /**
  * Generate MD5 hash string (lowercase)
  */
@@ -1005,4 +1386,4 @@ declare function safeCompare(a: string, b: string): boolean;
  */
 declare function getPaymentMethodCategory(code: string, name?: string): "Virtual Account" | "QRIS" | "E-Wallet" | "Retail / Gerai" | "Kartu Kredit" | "Paylater / Cicilan" | "Lainnya";
 
-export { BasePaymentProvider, Buayar, type BuayarConfig, CANONICAL_TO_DOKU, CANONICAL_TO_DUITKU, CANONICAL_TO_FASPAY, CANONICAL_TO_FINPAY, CANONICAL_TO_IPAYMU, CANONICAL_TO_MIDTRANS, CANONICAL_TO_NICEPAY, CANONICAL_TO_OY, CANONICAL_TO_PRISMALINK, CANONICAL_TO_XENDIT, CORE_API_METHODS, type CanonicalPaymentMethod, type CheckTransactionParams, type CheckTransactionResult, type CreateInvoiceParams, type CustomerDetails, DUITKU_TO_CANONICAL, DokuClient, DokuProvider, DuitkuClient, type DuitkuDisbursementParams, DuitkuProvider, FaspayClient, FaspayProvider, FinpayClient, FinpayProvider, type GetPaymentMethodsParams, type GetPaymentMethodsResult, type InvoiceResponse, IpaymuClient, IpaymuProvider, MIDTRANS_PROBE_PAYLOADS, MIDTRANS_STATIC_METHODS, type MandiriBillInfo, MidtransClient, MidtransProvider, NicepayClient, NicepayProvider, OyClient, OyProvider, PaymentManager, type PaymentMethod, type PaymentMethodItem, PrismalinkClient, PrismalinkProvider, type ProviderConfig, type VerifyCallbackResult, XenditClient, type XenditDisbursementParams, XenditProvider, buayar, buildCoreChargePayload, formatNicepayTimestamp, generateDokuHeaders, generateFaspaySignature, generateFinpaySignature, generateIpaymuSignature, generateNicepayToken, generateOyHeaders, generatePrismalinkSignature, getDuitkuInquirySignatures, getDuitkuPaymentMethodsSignature, getDuitkuStatusSignatures, getPaymentMethodCategory, getXenditAuthHeader, hmacSha256, md5, parseCoreChargeResponse, paymentManager, resolveConfigFromEnv, safeCompare, sha256, sha512, toCanonicalPaymentMethod, toDokuPaymentMethod, toDuitkuPaymentMethod, toFaspayPaymentMethod, toFinpayPaymentMethod, toIpaymuPaymentMethod, toNicepayPaymentMethod, toOyPaymentMethod, toPrismalinkPaymentMethod, toXenditPaymentMethod, verifyDokuWebhookSignature, verifyDuitkuCallbackSignature, verifyFaspaySignature, verifyFinpaySignature, verifyIpaymuCallback, verifyNicepayWebhook, verifyOyWebhook, verifyPrismalinkSignature, verifyXenditWebhookToken };
+export { AdyenClient, AdyenProvider, BasePaymentProvider, BraintreeClient, BraintreeProvider, Buayar, type BuayarConfig, CANONICAL_TO_DOKU, CANONICAL_TO_DUITKU, CANONICAL_TO_FASPAY, CANONICAL_TO_FINPAY, CANONICAL_TO_IPAYMU, CANONICAL_TO_MIDTRANS, CANONICAL_TO_NICEPAY, CANONICAL_TO_OY, CANONICAL_TO_PRISMALINK, CANONICAL_TO_STRIPE, CANONICAL_TO_XENDIT, CORE_API_METHODS, type CanonicalPaymentMethod, type CheckTransactionParams, type CheckTransactionResult, CheckoutComClient, CheckoutComProvider, type CreateInvoiceParams, type CustomerDetails, DUITKU_TO_CANONICAL, DokuClient, DokuProvider, DuitkuClient, type DuitkuDisbursementParams, DuitkuProvider, FaspayClient, FaspayProvider, FinpayClient, FinpayProvider, type GetPaymentMethodsParams, type GetPaymentMethodsResult, type InvoiceResponse, IpaymuClient, IpaymuProvider, MIDTRANS_PROBE_PAYLOADS, MIDTRANS_STATIC_METHODS, type MandiriBillInfo, MidtransClient, MidtransProvider, NicepayClient, NicepayProvider, OyClient, OyProvider, PaymentManager, type PaymentMethod, type PaymentMethodItem, PaypalClient, PaypalProvider, PayuClient, PayuProvider, PrismalinkClient, PrismalinkProvider, type ProviderConfig, RazorpayClient, RazorpayProvider, SquareClient, SquareProvider, StripeClient, StripeProvider, TwoCheckoutClient, TwoCheckoutProvider, type VerifyCallbackResult, XenditClient, type XenditDisbursementParams, XenditProvider, buayar, buildBraintreeBasicAuth, buildCoreChargePayload, buildPaypalBasicAuth, buildPayuBasicAuth, buildRazorpayBasicAuth, buildTwoCheckoutAuth, formatNicepayTimestamp, generateDokuHeaders, generateFaspaySignature, generateFinpaySignature, generateIpaymuSignature, generateNicepayToken, generateOyHeaders, generatePrismalinkSignature, getDuitkuInquirySignatures, getDuitkuPaymentMethodsSignature, getDuitkuStatusSignatures, getPaymentMethodCategory, getXenditAuthHeader, hmacSha256, md5, parseCoreChargeResponse, paymentManager, resolveConfigFromEnv, safeCompare, serializePaypalParams, serializeStripeParams, sha256, sha512, toCanonicalPaymentMethod, toDokuPaymentMethod, toDuitkuPaymentMethod, toFaspayPaymentMethod, toFinpayPaymentMethod, toIpaymuPaymentMethod, toNicepayPaymentMethod, toOyPaymentMethod, toPrismalinkPaymentMethod, toStripePaymentMethod, toXenditPaymentMethod, verifyAdyenWebhook, verifyBraintreeWebhook, verifyCheckoutComWebhook, verifyDokuWebhookSignature, verifyDuitkuCallbackSignature, verifyFaspaySignature, verifyFinpaySignature, verifyIpaymuCallback, verifyNicepayWebhook, verifyOyWebhook, verifyPaypalWebhookSimple, verifyPayuWebhook, verifyPrismalinkSignature, verifyRazorpayWebhook, verifySquareWebhook, verifyStripeWebhook, verifyTwoCheckoutWebhook, verifyXenditWebhookToken };