payfast 1.0.1

payfast: ^1.0.1 copied to clipboard

Updated #

• fixed IOS PlatformNavigationDelegate issue

Updated #

• Dart SDK updated to 3.8.1 to support latest language improvements and toolchain stability.
• Flutter SDK updated to 3.32.8.
• Updated package dependencies in pubspec.yaml to latest compatible versions

Added #

• onError callback for handling Payfast-related errors:

Example Usage

PayFast(
    ...
    onError: (errorMessage) {
        print('Payfast Error: $errorMessage');
    },
);

• Added

  • You can now retrieve the transaction data in the onPaymentCompleted callback.

  Example #

  PayFast(
      ...
      onPaymentCompleted: (data) {
          // payment completed
          // data holds the transaction details including the payment uuid
      },
  ) 
  

  Or

  void paymentCompleted(Map<String, dynamic> data) {
      // payment completed
      print(data);
  }
  
  PayFast(
      ...
      onPaymentCompleted: paymentCompleted,
  ) 
  

Improved #

• Enhanced error handling for improved stability and clearer error messages.

• DEPRECATIONS

  • additional_text An optional property that for additional text in data object (deprecated, use item_description instead).

• Added

  • Payment Flow Customization Introduced new parameters for localized/custom payment status screen content:

    • paymentCancelledButtonText: Customize the button text on payment cancellation screens Default: "Continue"

    • paymentCancelledTitle: Set a custom title for payment cancellation screens

    • paymentCompletedButtonText: Override the completion screen button text Default: "Continue"

    • paymentCompletedTitle: Define a custom title for successful payment screens

• Added new properties
  • additional_text An optional property that for additional text in data object.
    • merchant_id
    • merchant_key
    • name_first
    • name_last
    • amount
    • item_name
    • m_payment_id
    • additional_text (optional - used for payment details page)
  • defaultPaymentSummaryIcon An icon to display next to the payment summary item details.
  • itemSummarySectionLeadingWidget A custom widget to display next to the payment summary item details.
  • paymentSummaryAmountColor Set the total amount text color on the payment summary page
• Updated the payment summary details UI.

• Added new properties

  • onPaymentCompletedShapeBorder An optional property that defines the shape of the onPaymentCompleted widget's border.

  • onPaymentCancelledShapeBorder An optional property that defines the shape of the onPaymentCancelled widget's border.

  • animatedSwitcherWidget An optional property that allows you to pass customizable animation duration and transition builder parameters to override the current animation. This uses the AnimatedSwitcher animation.

  • backgroundColor The background color for the payment summary widget widget.

• Added FlutterFlow integration Widget & demonstration
• Added animation and transition effects for enhanced UI interactions.

• Updated README
• Added onsiteActivationScriptUrl Github links to use for development/testing

• Specified platforms in pubspec file, pub dev failing to identify the platforms

Features #

• Supports Sandbox and Live Environment: Configure whether to use Payfast's sandbox or live server.
• Customizable Payment Button: Provides a customizable payment button for users to initiate the payment.
• Payment Summary: Displays the payment summary widget before the user proceeds to payment.
• Callbacks for Payment Status: Customizable callback functions for when the payment is completed or cancelled.
• Customization: Fully customizable widgets for the payment flow, including custom widgets for payment cancellation and completion.