EdfaPay Logo

Deprecated APIs

A comprehensive list of deprecated methods, classes, and types in the Soft POS SDK with their modern replacements.

Overview

Modernization Policy

As the SDK evolves, we periodically rename or restructure APIs to improve consistency, clarity, and performance. While these deprecated items remain functional for backward compatibility, we strongly recommend migrating to the suggested replacements in your next update.

BNPL → Invoice Payment APIChanged in v1.0.7

In v1.0.7 the BNPL-specific API became the generic invoice payment API. Flutter removed the old names entirely (compile error); React Native keeps buyNowPayLater() and checkoutLinkApi() as deprecated aliases that forward to invoicePayment().

Deprecated ItemReplacementNotes
buyNowPayLater()invoicePayment()Removed in Flutter; deprecated alias in React Native.
checkoutLinkApi()invoiceRefund()Removed in Flutter; deprecated alias in React Native (forwards to invoicePayment()).
InvoiceRequestInvoicePaymentRequest / InvoiceRefundRequestSplit into payment and refund request models (Flutter/native; React Native keeps InvoiceRequest and adds InvoiceRefundRequest).
BnplResponseInvoicePaymentResponseRenamed (Flutter/native; unchanged in React Native).
BnplProviderPaymentMethodLowercase values: tamara, tabby, checkout, contactless, unknown. Use PaymentMethod.from(String) to map native names.
Loading...

ThemeDeprecated in v1.0.7

Deprecated ItemReplacementNotes
theme().setPoweredByImage()N/ANo longer effective as of v1.0.7; will be removed in a future release. Remove it from your theme configuration.

Callback Types

The following callback typealiases have been standardized with consistent naming conventions.

Deprecated ItemReplacementNotes
ProcessCompleteCallbackTransactionCompleteCallbackStandardized naming convention.
ServerCompletionCallBackServerResponseCallbackRenamed for clarity.
PluginCallBackCardProcessingCallbackClarified purpose.
TimeOutCallBackTimeoutCallbackFixed casing and standardized.
CancelByUserCallBackCancellationCallbackStandardized naming.
OnErrorCallBackErrorCallbackStandardized naming.
Loading...

Exceptions & Errors

The error handling system has moved from a mutable Error enum to a type-safe, immutable EdfaError sealed class.

EdfaException Members

Deprecated ItemReplacementNotes
EdfaException.typeEdfaException.errorThe new property returns the EdfaError sealed class.
Constructor(Error, ...)Constructor(EdfaError, ...)Transitioning to the new error model.

Error Enum (Legacy)

Deprecated ItemReplacementNotes
Error.exception()EdfaError.exception()Equivalent functionality in the new model.
Error.CUSTOM(message, ...)EdfaError.custom()Immutable replacement.
Error.CUSTOM(throwable)EdfaError.from(throwable)Enhanced error extraction.

The entire Error enum is deprecated in favor of EdfaError. Many helper methods on this enum have also been replaced.

QR Generator

The QR generation API has been overhauled to provide more flexibility and better performance using vector-based options.

Main Components

Deprecated ItemReplacementNotes
QrOptionsQrCodeDrawable / QrVectorOptionsModernized vector-based options.
QrOptions.BuilderQrVectorOptions.BuilderNew builder for vector options.
createQrOptionscreateQrVectorOptionsDSL method for vector QR codes.

Deprecated Style Classes

The following QR style classes have been replaced with their QrVector* equivalents: QrLogoShape → QrVectorLogoShape QrBackground → QrVectorBackground QrHighlightingShape → QrVectorHighlightingShape QrLogoPadding → QrVectorLogoPadding QrLogo → QrVectorLogo QrBallShape → QrVectorBallShape QrFrameShape → QrVectorFrameShape QrShape → QrVectorShape QrOffset → QrVectorOffset QrColors → QrVectorColors

Utilities

Deprecated ItemReplacementNotes
HttpLoggingInterceptor.levelN/AProperty access deprecated in favor of internal management.