Feat: Add code snippets for Flutter and React Native

Author: damilola-paystack

src/doc/guides/terminal-flutter/create-method-channel/config.yml

@@ -0,0 +1,2 @@
+languages:
+  - kt

src/doc/guides/terminal-flutter/create-method-channel/index.kt

@@ -0,0 +1,25 @@
+// other imports
+import io.flutter.embedding.engine.FlutterEngine
+import io.flutter.plugin.common.MethodChannel
+
+class MainActivity: FlutterActivity() {
+	private val CHANNEL = "com.example.sample_registration/payment"
+	// other code snippet
+	override fun configureFlutterEngine(flutterEngine: FlutterEngine) {
+      super.configureFlutterEngine(flutterEngine)
+
+      MethodChannel(flutterEngine.dartExecutor.binaryMessenger, CHANNEL).setMethodCallHandler {
+          call, result ->
+        if (call.method == "makePayment") {
+          val amount = call.argument("amount") ?: 0
+          makePayment(amount)
+
+          result.success(transactionStatus)
+        } else {
+          result.notImplemented()
+        }
+    }
+  }
+	
+	// other code snippet
+}

src/doc/guides/terminal-flutter/create-models/config.yml

@@ -0,0 +1,3 @@
+type: single-lang
+languages:   
+  - kt

src/doc/guides/terminal-flutter/create-models/paystack-intent-response.kt

@@ -0,0 +1,7 @@
+
+// PaystackIntentResponse.kt
+data class PaystackIntentResponse (
+    val intentKey: String,
+    val intentResponseCode: Int,
+    val intentResponse: TerminalResponse
+)

src/doc/guides/terminal-flutter/create-models/terminal-response.kt

@@ -0,0 +1,7 @@
+
+// TerminalResponse.kt
+data class TerminalResponse(
+    val statusCode: String,
+    val message: String,
+    val data: String
+)

src/doc/guides/terminal-flutter/create-models/transaction-request.kt

@@ -0,0 +1,20 @@
+
+// TransactionRequest.kt
+data class TransactionRequest(
+    val amount: Int,
+    val offlineReference: String?,
+    val supplementaryReceiptData: SupplementaryReceiptData?,
+    val metadata: Map<String, Any>?
+)
+
+data class SupplementaryReceiptData(
+    val developerSuppliedText: String?,
+    val developerSuppliedImageUrlPath: String?,
+    val barcodeOrQrcodeImageText: String?,
+    val textImageType: TextImageFormat?
+)
+
+enum class TextImageFormat {
+    QR_CODE,
+    AZTEC_BARCODE
+}

src/doc/guides/terminal-flutter/create-models/transaction-response.kt

@@ -0,0 +1,15 @@
+// TransactionResponse.kt
+import com.google.gson.annotations.SerializedName
+
+data class TransactionResponse(
+    val id: String?,
+    val amount: Int?,
+    val reference: String?,
+    val status: String?,
+    val currency: String?,
+    @SerializedName("country_code")
+    val countryCode: String?,
+    @SerializedName("paid_at")
+    val paidAt: String?,
+    val terminal: String?
+)

src/doc/guides/terminal-flutter/create-payment-intent/config.yml

@@ -0,0 +1,2 @@
+languages:
+  - kt

src/doc/guides/terminal-flutter/create-payment-intent/index.kt

@@ -0,0 +1,76 @@
+// MainActivity.kt
+import android.content.Intent
+import android.util.Log
+import android.widget.Toast
+import com.example.sample_registration.model.CustomField
+import com.example.sample_registration.model.PaystackIntentResponse
+import com.example.sample_registration.model.TerminalResponse
+import com.example.sample_registration.model.TransactionRequest
+import com.example.sample_registration.model.TransactionResponse
+import com.google.gson.Gson
+import io.flutter.embedding.android.FlutterActivity
+
+class MainActivity: FlutterActivity() {
+  private val gson = Gson()
+  private var transactionStatus: String? = ""
+
+  private val CHANNEL = "com.example.sample_registration/payment"
+  private val PACKAGE_NAME = "com.paystack.pos"
+  private val TRANSACTION = "com.paystack.pos.TRANSACT"
+  private val TRANSACTION_RESULT_CODE = 14
+
+
+  private fun makePayment(amount: Int?) {
+    val transactionRequest = amount?.let {
+      TransactionRequest(
+        amount = it,
+        offlineReference = null,
+        supplementaryReceiptData = null,
+        metadata = mapOf(
+          "custom_fields" to listOf(
+            CustomField(
+              displayName = "App Name",
+              variableName = "app_name",
+              value = "Sample Registration"
+            )
+          )
+        )
+      )
+    }
+
+    val transactionIntent = Intent(Intent.ACTION_VIEW).apply {
+      setPackage(PACKAGE_NAME)
+      putExtra(TRANSACTION, gson.toJson(transactionRequest))
+    }
+
+    startActivityForResult(transactionIntent, 1)
+  }
+
+  override fun onActivityResult(requestCode: Int, resultCode: Int, data: Intent?) {
+    super.onActivityResult(requestCode, resultCode, data)
+    val paystackIntentResponse: PaystackIntentResponse
+
+    if (resultCode == TRANSACTION_RESULT_CODE) {
+      paystackIntentResponse = gson.fromJson(
+        data?.getStringExtra(TRANSACTION),
+        PaystackIntentResponse::class.java
+      )
+
+      processResponse(paystackIntentResponse)
+    }
+    else {
+      // handle invalid result code
+    }
+  }
+
+  private fun processResponse(response: PaystackIntentResponse) {
+
+    val terminalResponse: TerminalResponse = response.intentResponse
+    val transactionResponse = gson.fromJson(
+      terminalResponse.data,
+      TransactionResponse::class.java
+    )
+
+    transactionStatus = transactionResponse.reference
+  }
+}

src/doc/guides/terminal-flutter/link-method-channel/config.yml

@@ -0,0 +1,2 @@
+languages:
+  - dart