Skip to main content

pluspay_a2a 0.8.0 copy "pluspay_a2a: ^0.8.0" to clipboard
pluspay_a2a: ^0.8.0 copied to clipboard

Published 29 days ago
SDKFlutter
PlatformAndroid
→

Metadata

PlusPay A2A (app-to-app) payment plugin for Android POS devices — start payments, EOD, refunds and transaction queries.

More...

Changelog #

All notable changes to this project will be documented in this file.

The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.

0.8.0 - 2026-10-09 #

Added #

  • İşlem sonucu sorgusu (TRANSACTION_RESULT): Yeni getTransactionResult metodu ve PPTransactionResultRequestModel (orderCode, transactionId). Tek bir işlemin güncel durumunu PPStartPaymentResponseModel olarak döner; işlem bulunamazsa PP_A2A_016 fırlatılır.
  • Sipariş sonucu sorgusu (ORDER_RESULT): Yeni getOrderResult metodu ve PPOrderResultRequestModel (orderCode). Ödeme başlatmadan siparişi ve tüm işlemlerini PPOrderPaymentResponseModel olarak döner.
  • Teknik iptal (POST_TECHNICAL_CANCEL): Yeni technicalCancel metodu, PPTechnicalCancelRequestModel (orderCode, transactionId) ve PPTechnicalCancelResponseModel (orderCode, transactionId, status).
  • Dil seçimi (locale): PPGeneralRequestHeader'a locale alanı, tüm toRequest factory'lerine opsiyonel locale parametresi, initialize(locale: ...) ve PPA2AClient.locale eklendi. POS+ arayüzü işlem süresince bu dile geçer. Desteklenen diller ppSupportedLocales sabitindedir.
  • PPA2AErrorCodes: POS+ ve istemci hata kodları için sabitler (PP_A2A_001–PP_A2A_016, LAUNCH_INTENT_ERROR, PP-A2A-PARSE). Yeni kodlar: PP_A2A_014 (zaman aşımı), PP_A2A_015 (önceki istek işleniyor), PP_A2A_016 (işlem bulunamadı).
  • Enum değerleri: PPTransactionType'a POST_TECHNICAL_CANCEL, TRANSACTION_RESULT, ORDER_RESULT; PPPaymentType'a INSTALLMENT; PPPaymentMethod'a CHIP, LINK, NFC_R, PAYCELL_LINK, PAYCELL_MERCHANT_PAGE; PPOrderSourceEnum'a TSM; PPTransactionTypeEnum'a IADE; PPParameterTypes'a sodexo eklendi.

Changed #

  • Bilinmeyen enum değerleri artık hata vermez (UNKNOWN): POS+ bu paket sürümünün tanımadığı bir enum değeri döndürdüğünde yanıtın tamamı parse hatasına düşmek yerine ilgili alan UNKNOWN olur (PPParameterTypes için unknown). Yanıtlarda kullanılan tüm enum'lara bu değer eklendi. Zorunlu alanlar zorunlu kalır; alan hiç gelmezse de UNKNOWN olur. Zaten nullable olan alanlar nullable kalır (null = alan gönderilmedi). PPPaymentTypeMethodsModel.methods listesinde bilinmeyen değerler atlanır; PPMultiPaymentResponseModel.source alan gelmezse POS, bilinmeyen değerde UNKNOWN olur. UNKNOWN yalnızca yanıtlarda görülür, istek gönderirken kullanılmamalıdır.
  • Dikkat — exhaustive switch: Enum'lara yeni değerler (UNKNOWN, INSTALLMENT, LINK vb.) eklendiği için bu enum'lar üzerinde tüm değerleri ele alan switch ifadeleri yeni case'ler (veya default) gerektirebilir. Bunun dışında API geriye dönük uyumludur; alan tipleri değişmedi.
  • Aynı anda tek istek: Bir isteğin cevabı beklenirken yeni istek gönderilirse istemci intent atmadan PP_A2A_015 fırlatır. Önceden yeni istek, bekleyen isteğin Future'ını sahipsiz bırakıyordu. 20 dakikadan uzun süredir cevapsız kalan istek kaybolmuş sayılır (PP_A2A_014 ile sonlanır) ve yeni isteği engellemez.

Fixed #

  • LAUNCH_INTENT_ERROR durumunda bekleyen istek temizlenmiyordu; sonraki istekler etkilenebiliyordu.
  • README örneklerindeki artık var olmayan clientToken parametresi kaldırıldı.

Notes #

  • POS+'ın döndürdüğü error_message her zaman Türkçedir; kullanıcıya gösterilecek metni errorCode üzerinden üretin.
  • POS+ açılış için 3 dakika, işlem için 15 dakika bekler; istemci tarafı zaman aşımları 15 dakikadan uzun olmalıdır.
  • locale ve yeni operasyonlar POS+'ın bu özellikleri içeren sürümünü gerektirir; eski POS+ sürümleri locale'i yok sayar ve yeni operasyonları hata ile reddeder.

0.7.0 - 2026-08-25 #

Added #

  • Sipariş oluşturma (ORDER_CREATE): Ödeme başlatmadan yalnızca sipariş oluşturmak için yeni createOrder metodu eklendi. Oluşturulan sipariş daha sonra startOrderPayment ile tahsil edilebilir; orderCode zaten kayıtlıysa sipariş güncellenir.
  • PPOrderCreateRequest: toRequest() ile üretilen yeni istek modeli. Alanlar PPMultiPaymentRequest ile aynıdır; transactions, changePaymentStatus, canTryAgain ve startTime bulunmaz.
  • PPOrderCreateResponseModel: PPMultiPaymentResponseModel için typedef; sipariş detayını döner.
  • PPTransactionType: Yeni ORDER_CREATE değeri eklendi.

Notes #

  • Tutarlar bu istekte düz ondalık (100.0) olarak gönderilir.
  • Değişiklik geriye dönük uyumludur (breaking değil).

0.6.0 - 2026-06-29 #

Added #

  • Mevcut ödeme yöntemleri sorgusu (AVAILABLE_PAYMENT_METHODS): POS+ üzerinde o an aktif/kullanılabilir ödeme tiplerini ve yöntemlerini öğrenmek için yeni getAvailablePaymentMethods metodu eklendi. Liste, oturumun profil ve cihaz filtrelerinden geçmiş hâliyle döner (örn. nakit yetkisi yoksa CASH listede olmaz; fiziksel POS'ta Multinet/Metropol için SWIPE eklenir).
  • PPAvailablePaymentMethodsRequestModel: Yalnızca header içeren, data gerektirmeyen yeni istek modeli (toRequest()).
  • PPAvailablePaymentMethodsResponseModel: paymentTypes listesini taşıyan yeni yanıt modeli. Her öğe PPPaymentTypeMethodsModel olup code (PPPaymentType), methods (List<PPPaymentMethod>) ve opsiyonel title alanlarını içerir.
  • PPTransactionType: Yeni AVAILABLE_PAYMENT_METHODS değeri eklendi.

Notes #

  • Yanıttaki code ve methods alanları mevcut PPPaymentType / PPPaymentMethod enum'larıyla eşleşir.
  • Değişiklik geriye dönük uyumludur (breaking değil).

0.5.1 - 2026-06-26 #

Changed #

  • Dokümantasyon: Paket pub.dev üzerinde yayınlandı. README kurulum talimatları Git bağımlılığı yerine flutter pub add pluspay_a2a / pluspay_a2a: ^0.5.1 standart pub.dev kurulumuna güncellendi. pubspec.yaml içine description, homepage ve repository alanları, kök dizine MIT LICENSE eklendi.

0.5.0 - 2026-06-04 #

Fixed #

  • PPMultiPaymentRequest.toRequest – currency artık dikkate alınıyor: Önceden currency parametresi yok sayılıp gövdeye sabit PPCurrencyType.TRY yazılıyordu. Artık çağrıda verilen currency değeri (TRY/USD/EUR/GBP) doğru şekilde gönderiliyor.

Added #

  • ProductModel – otvOrani ve konaklamaOrani: Çoklu ödeme ürünlerine ÖTV ve konaklama oranı alanları eklendi (otv_orani / konaklama_orani, varsayılan 0). POS+ tarafı bu alanları artık okuyor.
  • PPMultiPaymentRequest – canTryAgain: toRequest ve PPMultiPaymentRequestData için canTryAgain alanı eklendi (can_try_again, varsayılan true).
  • PPBillingInfo – code: Fatura bilgisine opsiyonel code alanı eklendi (code).

Notes #

  • Tüm yeni alanlar varsayılan değerlere sahiptir; değişiklik geriye dönük uyumludur (breaking değil).

0.4.0 - 2026-06-03 #

Changed #

  • BREAKING – clientToken removed: The clientToken parameter is no longer required (or accepted) by any request. It has been commented out across all toRequest factories and the PPGeneralRequestHeader model, and is no longer included in the request payload. It may be re-enabled in a future release.
    • Affected requests: PPStartPaymentRequestModel, PPCancelPaymentRequestModel, PPEftPaymentRequestModel, PPEftCancelRequestModel, PPOrderPaymentRequestModel, PPMultiPaymentRequest, PPParameterRequestModel, PPEodRequestModel.
    • Migration: remove any clientToken: arguments from your toRequest(...) calls.

0.3.1 - 2026-05-08 #

Removed #

  • PPMultiPaymentRequest: Removed required serialNo parameter from toRequest factory. The field is no longer part of the multi payment request payload.

0.3.0 - 2026-03-05 #

Added #

  • Multi Payment support: New startMultiPayment method on PPA2AClient for order-based multi-payment flows
  • PPMultiPaymentRequest: New request model with toRequest factory, supporting products, transactions, billing info, delivery options, and more
  • PPMultiPaymentResponseModel: Comprehensive response model with detailed product, transaction, tax, card info, and document sub-models
  • ProductModel and TransactionModel: New models for defining products and transactions in multi-payment requests
  • Formatter utility class for DateTime serialization (yyyy-MM-dd HH:mm format)
  • New enums:
    • PPCurrencyType (TRY, USD, EUR, GBP)
    • PPProductTypeEnum (PHYSICALLY, VIRTUAL, INFO, MD, DSN, QP, KFO, COMMISSION, HGS)
    • PPQtyEnums (ADET, KG, GR, LT, MT, KOLI, PAKET, PORSIYON)
    • PPDiscountTypeEnum (PERCENTAGE, FIXED_AMOUNT)
    • PPOrderSourceEnum (POS, WEB, KIOSK)
    • PPDocumentTypeEnum (EFATURA, EARSIV, BILGIFISI)
    • PPDocumentStatusEnum (SUCCESS, CANCEL, FAIL, WAITING, NONE)
    • PPTransactionStatusEnum (SUCCESS, CANCEL, FAIL, NONE, WAITING, NOT_RESPONSE)
    • PPTransactionTypeEnum (START, SATIS, CANCEL, REFUND)
    • ORDER_MULTI_PAYMENT added to PPTransactionType
  • New dependency: intl package for date formatting

0.2.3 - 2026-02-26 #

Removed #

  • PPDeviceTypeEnum: Removed enum entirely (POS, KIOSK values no longer exist)
  • PPGeneralRequestHeader: Removed deviceType field
  • Removed deviceType parameter from the following toRequest factory methods:
    • PPStartPaymentRequestModel.toRequest()
    • PPCancelPaymentRequestModel.toRequest()
    • PPEftPaymentRequestModel.toRequest()
    • PPEftCancelRequestModel.toRequest()
    • PPOrderPaymentRequestModel.toRequest()

0.2.2 - 2026-02-17 #

Added #

  • PPDeviceTypeEnum: New enum with POS and KIOSK values to specify the target device type
  • PPGeneralRequestHeader: New optional deviceType field (defaults to PPDeviceTypeEnum.POS)
  • Optional deviceType parameter added to the following toRequest factory methods:
    • PPStartPaymentRequestModel.toRequest()
    • PPCancelPaymentRequestModel.toRequest()
    • PPEftPaymentRequestModel.toRequest()
    • PPEftCancelRequestModel.toRequest()
    • PPOrderPaymentRequestModel.toRequest()

0.2.1 - 2026-02-12 #

Changed #

  • Example project now uses tag-based package imports instead of branch references

0.2.0 - 2026-02-12 #

Breaking Changes #

  • PPGeneralRequestHeader: Removed serialNo field. Only clientToken is now required for authentication.
  • All request model toRequest factory methods no longer require serialNo parameter:
    • PPStartPaymentRequestModel.toRequest()
    • PPCancelPaymentRequestModel.toRequest()
    • PPEftPaymentRequestModel.toRequest()
    • PPEftCancelRequestModel.toRequest()
    • PPOrderPaymentRequestModel.toRequest()
    • PPEodRequestModel.toRequest()
    • PPParameterRequestModel.toRequest()

Migration Guide #

Remove serialNo from all toRequest calls:

// Before (0.1.0)
PPStartPaymentRequestModel.toRequest(
  serialNo: 'DEVICE-SERIAL-001',  // Remove this line
  clientToken: 'YOUR-CLIENT-TOKEN',
  orderCode: 'ORD-001',
  totalAmount: 100.0,
  paymentType: PPPaymentType.POS,
  paymentMethod: PPPaymentMethod.CC,
);

// After (0.2.0)
PPStartPaymentRequestModel.toRequest(
  clientToken: 'YOUR-CLIENT-TOKEN',
  orderCode: 'ORD-001',
  totalAmount: 100.0,
  paymentType: PPPaymentType.POS,
  paymentMethod: PPPaymentMethod.CC,
);

0.1.0 - 2026-02-04 #

Breaking Changes #

  • PPGeneralRequestHeader: Added serialNo and clientToken as required fields
  • All request model toRequest factory methods now require serialNo and clientToken parameters

Migration Guide #

Update all toRequest calls to include the new required parameters:

// Before (0.0.1)
PPStartPaymentRequestModel.toRequest(
  orderCode: 'ORD-001',
  totalAmount: 100.0,
  paymentType: PPPaymentType.POS,
  paymentMethod: PPPaymentMethod.CC,
);

// After (0.1.0)
PPStartPaymentRequestModel.toRequest(
  serialNo: 'DEVICE-SERIAL-001',
  clientToken: 'YOUR-CLIENT-TOKEN',
  orderCode: 'ORD-001',
  totalAmount: 100.0,
  paymentType: PPPaymentType.POS,
  paymentMethod: PPPaymentMethod.CC,
);

0.0.1 - 2025-01-01 #

Added #

  • Initial release of pluspay_a2a Flutter plugin
  • App-to-App (A2A) communication with POS+ Android application
  • Payment operations: startPayment, cancelPayment
  • EFT POS operations: startEftPayment, cancelEftPayment
  • Order payment: startOrderPayment
  • End of day reports: triggerEod
  • Parameter updates: triggerParameters
  • Comprehensive request/response models with Freezed
  • Error handling with PPA2AException

← Metadata

0
likes
160
points
120
downloads

Documentation

API reference

Publisher

unverified uploader

Weekly Downloads

Metadata

PlusPay A2A (app-to-app) payment plugin for Android POS devices — start payments, EOD, refunds and transaction queries.

Homepage

License

MIT (license)

Dependencies

android_intent_plus, flutter, freezed_annotation, intl, plugin_platform_interface

More

Packages that depend on pluspay_a2a

Packages that implement pluspay_a2a

Back