dimepay_flutter_sdk 1.0.2

Official Flutter SDK for integrating Dime Pay.

💳 Dime Pay Flutter SDK

The official Flutter SDK for embedding the Dime Pay secure payment experience into native apps using WebView.

🚀 Installation

flutter pub add dimepay_flutter_sdk

🧩 Usage

DimePayWebView(
  total: 5000,
  currency: "JMD",
  test: true,
  orderId: "ORDER-001",
  clientId: "ck_jtfEtqbrX2Nf7U_evqKVy",
  data: "<signed_jwt_token>",
  payment_methods: {
    apple_pay: true,
    google_pay: true,
    samsung_pay: true
  },
  styles: DimePayStyles(
    primaryColor: "#936c6c",
    buttonColor: "#936c6c",
    buttonTextColor: "#FFFFFF",
    backgroundColor: "#DDDDDD",
    noBorderRadius: false,
  ),
  onReady: (data) => print("✅ Ready: \$data"),
  onSuccess: (data) => print("✅ Success: \$data"),
  onFailed: (err) => print("❌ Failed: \$err"),
  onError: (err) => print("❌ Error: \$err"),
  onCancel: () => print("⚠️ Cancelled"),
  onLoading: () => print("⏳ Loading..."),
)

🔐 Secure JWT Flow

You must pass a signed JWT to data prop containing transaction info. Sign this on your server.

---

🔐 Secure Payment Flow with JWT

You must generate a signed JWT on your backend and pass it to the SDK via the data prop.

Example payload:

{
  "id": "ORDER-001",
  "total": 5000,
  "subtotal": 5000,
  "description": "This is an order from the sdk",
  "tax": 0,
  "currency": "JMD",
  "fees": [],
  "items": [],
  "fulfilled": true,
  "shippingPerson": {
    "name": "Shamir Saddler",
    "street": "1 Test Ave",
    "city": "Kingston 6",
    "stateOrProvinceName": "Kingston",
    "postalCode": "00000",
    "countryName": "Jamaica"
  },
  "billingPerson": {
    "name": "Shamir Saddler",
    "street": "1 Test Ave",
    "city": "Kingston 6",
    "stateOrProvinceName": "Kingston",
    "postalCode": "00000",
    "countryName": "Jamaica"
  },
  "webhookUrl": "https://yourservice.com/webhook"
}

Use a backend library like jsonwebtoken to sign the payload with your secret key. Never expose your secret key in your app.

---

⚙️ Configuration Options

Prop	Type	Required	Description
total	number	✅	The total amount to charge
currency	string	✅	The currency code (e.g. JMD, USD)
order_id	string	✅	Your order reference
client_id	string	✅	Client ID for your integration
data	string	✅	Signed JWT with payment details
payment_methods	object	optional	Defines payment methods to enable
styles	object	optional	Customizes UI (colors, border radius, etc.)
test	boolean	optional	Set true for sandbox environment
onReady	func	optional	Called when payment page is ready
onSuccess	func	optional	Called when payment completes successfully
onFailed	func	optional	Called if payment fails
onError	func	optional	Called on internal error
onCancel	func	optional	Called when user cancels
onLoading	func	optional	Called when payment widget begins loading

---

🧾 Changelog

[1.0.2] - 2025-06-26

• Add support for Apple Pay, Google Pay, Samsung Pay

[1.0.0] - 2025-05-14

• 🚀 Initial release
• ✅ Supports full payment flow with JWT + WebView
• 📡 Handles events: onReady, onSuccess, onError, onCancel, etc.

---

🛡️ License

MIT License © Dime Pay