@bcc-code/payment-client 1.0.7 → 1.1.0

package/README.md

@@ -66,6 +66,14 @@ const status = await client.getPayment(payment.paymentId)
 
 // Get receipt
 const receipt = await client.getReceipt(payment.paymentId)
+
+// Discover available payment methods for a specific context
+const paymentMethods = await client.getPaymentMethods({
+  currency: 'EUR',
+  amount: 100,
+  churchId: 'your-church-uuid',
+  isCompany: false
+})
 ```
 
 ## Vue Components Usage

package/dist/index.d.mts

@@ -1,3 +1,13 @@
+/** Company details required for Tripletex invoice creation. */
+interface InvoiceRecipientRequest {
+    companyName: string;
+    address: string;
+    postalCode: string;
+    city: string;
+    country: string;
+    vatNumber: string;
+    email: string;
+}
 interface CreatePaymentRequest {
     payerId?: string;
     amount: number;
@@ -9,6 +19,10 @@ interface CreatePaymentRequest {
     paymentMethodDetails?: Record<string, unknown>;
     person?: PersonInfoRequest;
     lineItems?: LineItemRequest[];
+    /** Whether to create a Tripletex invoice when payment succeeds. */
+    invoiceRequested?: boolean;
+    /** Required when invoiceRequested is true. */
+    invoiceRecipient?: InvoiceRecipientRequest;
 }
 interface PersonInfoRequest {
     payerUid: string;
@@ -49,6 +63,8 @@ interface PaymentResponse {
     createdAt: string;
     updatedAt: string;
     lineItems?: LineItemResponse[];
+    invoiceRequested?: boolean;
+    tripletexInvoiceId?: string | null;
 }
 interface LineItemResponse {
     id: string;
@@ -87,6 +103,9 @@ interface PaymentReceiptResponse {
     taxAmount?: number;
     discountAmount?: number;
     amountFormatted?: string;
+    productName?: string;
+    invoiceRequested?: boolean;
+    tripletexInvoiceId?: string | null;
 }
 interface PaymentSucceededNotification {
     paymentId: string;
@@ -96,6 +115,13 @@ interface PaymentSucceededNotification {
     status: string;
     timestamp: string;
 }
+interface GetPaymentMethodsOptions {
+    provider?: string;
+    currency?: string;
+    amount?: number;
+    churchId?: string;
+    isCompany?: boolean;
+}
 
 interface PaymentClientOptions {
     baseUrl: string;
@@ -114,6 +140,7 @@ declare class PaymentClient {
     getPayment(paymentId: string): Promise<PaymentResponse | null>;
     getReceipt(paymentId: string): Promise<PaymentReceiptResponse | null>;
     getTotalAmountByPrefix(prefix: string): Promise<number>;
+    getPaymentMethods(options?: GetPaymentMethodsOptions): Promise<unknown>;
 }
 
 interface StripePaymentProps {
@@ -139,4 +166,4 @@ interface AdyenPaymentProps {
     onCancel?: () => void;
 }
 
-export { type AdyenPaymentProps, type CreatePaymentRequest, type CreatePaymentResponse, type LineItemRequest, type LineItemResponse, PaymentClient, type PaymentClientOptions, type PaymentReceiptResponse, type PaymentResponse, type PaymentSucceededNotification, type PersonInfoRequest, type StripePaymentProps };
+export { type AdyenPaymentProps, type CreatePaymentRequest, type CreatePaymentResponse, type GetPaymentMethodsOptions, type InvoiceRecipientRequest, type LineItemRequest, type LineItemResponse, PaymentClient, type PaymentClientOptions, type PaymentReceiptResponse, type PaymentResponse, type PaymentSucceededNotification, type PersonInfoRequest, type StripePaymentProps };

package/dist/index.d.ts

@@ -1,3 +1,13 @@
+/** Company details required for Tripletex invoice creation. */
+interface InvoiceRecipientRequest {
+    companyName: string;
+    address: string;
+    postalCode: string;
+    city: string;
+    country: string;
+    vatNumber: string;
+    email: string;
+}
 interface CreatePaymentRequest {
     payerId?: string;
     amount: number;
@@ -9,6 +19,10 @@ interface CreatePaymentRequest {
     paymentMethodDetails?: Record<string, unknown>;
     person?: PersonInfoRequest;
     lineItems?: LineItemRequest[];
+    /** Whether to create a Tripletex invoice when payment succeeds. */
+    invoiceRequested?: boolean;
+    /** Required when invoiceRequested is true. */
+    invoiceRecipient?: InvoiceRecipientRequest;
 }
 interface PersonInfoRequest {
     payerUid: string;
@@ -49,6 +63,8 @@ interface PaymentResponse {
     createdAt: string;
     updatedAt: string;
     lineItems?: LineItemResponse[];
+    invoiceRequested?: boolean;
+    tripletexInvoiceId?: string | null;
 }
 interface LineItemResponse {
     id: string;
@@ -87,6 +103,9 @@ interface PaymentReceiptResponse {
     taxAmount?: number;
     discountAmount?: number;
     amountFormatted?: string;
+    productName?: string;
+    invoiceRequested?: boolean;
+    tripletexInvoiceId?: string | null;
 }
 interface PaymentSucceededNotification {
     paymentId: string;
@@ -96,6 +115,13 @@ interface PaymentSucceededNotification {
     status: string;
     timestamp: string;
 }
+interface GetPaymentMethodsOptions {
+    provider?: string;
+    currency?: string;
+    amount?: number;
+    churchId?: string;
+    isCompany?: boolean;
+}
 
 interface PaymentClientOptions {
     baseUrl: string;
@@ -114,6 +140,7 @@ declare class PaymentClient {
     getPayment(paymentId: string): Promise<PaymentResponse | null>;
     getReceipt(paymentId: string): Promise<PaymentReceiptResponse | null>;
     getTotalAmountByPrefix(prefix: string): Promise<number>;
+    getPaymentMethods(options?: GetPaymentMethodsOptions): Promise<unknown>;
 }
 
 interface StripePaymentProps {
@@ -139,4 +166,4 @@ interface AdyenPaymentProps {
     onCancel?: () => void;
 }
 
-export { type AdyenPaymentProps, type CreatePaymentRequest, type CreatePaymentResponse, type LineItemRequest, type LineItemResponse, PaymentClient, type PaymentClientOptions, type PaymentReceiptResponse, type PaymentResponse, type PaymentSucceededNotification, type PersonInfoRequest, type StripePaymentProps };
+export { type AdyenPaymentProps, type CreatePaymentRequest, type CreatePaymentResponse, type GetPaymentMethodsOptions, type InvoiceRecipientRequest, type LineItemRequest, type LineItemResponse, PaymentClient, type PaymentClientOptions, type PaymentReceiptResponse, type PaymentResponse, type PaymentSucceededNotification, type PersonInfoRequest, type StripePaymentProps };

package/dist/index.js

@@ -131,6 +131,36 @@ var PaymentClient = class {
     }
     return await response.json();
   }
+  async getPaymentMethods(options = {}) {
+    const token = await this.getAuthToken();
+    const params = new URLSearchParams();
+    if (options.provider) params.set("provider", options.provider);
+    if (options.currency) params.set("currency", options.currency);
+    if (options.amount != null) params.set("amount", options.amount.toString());
+    if (options.churchId) params.set("churchId", options.churchId);
+    if (options.isCompany != null) params.set("isCompany", options.isCompany.toString());
+    const controller = new AbortController();
+    if (this.timeout) {
+      setTimeout(() => controller.abort(), this.timeout);
+    }
+    const response = await fetch(
+      `${this.baseUrl}/api/v1/configuration/payment-methods?${params.toString()}`,
+      {
+        headers: {
+          "Authorization": `Bearer ${token}`,
+          "X-Tenant-ID": this.tenantId
+        },
+        signal: controller.signal
+      }
+    );
+    if (!response.ok) {
+      const errorText = await response.text();
+      throw new Error(
+        `Payment API request failed: ${response.status} ${response.statusText}. ${errorText}`
+      );
+    }
+    return await response.json();
+  }
 };
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {

package/dist/index.mjs

@@ -105,6 +105,36 @@ var PaymentClient = class {
     }
     return await response.json();
   }
+  async getPaymentMethods(options = {}) {
+    const token = await this.getAuthToken();
+    const params = new URLSearchParams();
+    if (options.provider) params.set("provider", options.provider);
+    if (options.currency) params.set("currency", options.currency);
+    if (options.amount != null) params.set("amount", options.amount.toString());
+    if (options.churchId) params.set("churchId", options.churchId);
+    if (options.isCompany != null) params.set("isCompany", options.isCompany.toString());
+    const controller = new AbortController();
+    if (this.timeout) {
+      setTimeout(() => controller.abort(), this.timeout);
+    }
+    const response = await fetch(
+      `${this.baseUrl}/api/v1/configuration/payment-methods?${params.toString()}`,
+      {
+        headers: {
+          "Authorization": `Bearer ${token}`,
+          "X-Tenant-ID": this.tenantId
+        },
+        signal: controller.signal
+      }
+    );
+    if (!response.ok) {
+      const errorText = await response.text();
+      throw new Error(
+        `Payment API request failed: ${response.status} ${response.statusText}. ${errorText}`
+      );
+    }
+    return await response.json();
+  }
 };
 export {
   PaymentClient

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bcc-code/payment-client",
-  "version": "1.0.7",
+  "version": "1.1.0",
   "description": "Client SDK for BCC Payment Orchestrator API",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",