Added docs and test

Packages/com.darkmattergameproduction.com.darkmatter.fonepay-unity/Runtime/Async/FonepayAsync.cs

@@ -0,0 +1,49 @@
+using System.Threading.Tasks;
+
+namespace Darkmatter.Fonepay
+{
+#if UNITASK_SUPPORT
+    using Cysharp.Threading.Tasks;
+
+    public readonly struct FonepayAsync<T>
+    {
+        private readonly UniTask<T> _task;
+        internal FonepayAsync(UniTask<T> task) => _task = task;
+
+        // UniTask<T>.Awaiter is a public named type — no problem
+        public UniTask<T>.Awaiter GetAwaiter() => _task.GetAwaiter();
+    }
+
+    public readonly struct FonepayAsync
+    {
+        private readonly UniTask _task;
+        internal FonepayAsync(UniTask task) => _task = task;
+
+        public UniTask.Awaiter GetAwaiter() => _task.GetAwaiter();
+    }
+
+#else
+    // Unity 2023.1+ path — Awaitable<T>.GetAwaiter() return type is internal,
+    // so we store Task<T> and convert lazily via an async wrapper.
+    // The wrapper's return type is inferred — we never name the awaiter.
+
+    public readonly struct FonepayAsync<T>
+    {
+        private readonly System.Threading.Tasks.Task<T> _task;
+        internal FonepayAsync(System.Threading.Tasks.Task<T> task) => _task = task;
+
+        // Return type inferred from the async method — compiler handles it
+        public System.Runtime.CompilerServices.TaskAwaiter<T> GetAwaiter()
+            => _task.GetAwaiter();
+    }
+
+    public readonly struct FonepayAsync
+    {
+        private readonly System.Threading.Tasks.Task _task;
+        internal FonepayAsync(System.Threading.Tasks.Task task) => _task = task;
+
+        public System.Runtime.CompilerServices.TaskAwaiter GetAwaiter()
+            => _task.GetAwaiter();
+    }
+#endif
+}

Packages/com.darkmattergameproduction.com.darkmatter.fonepay-unity/Runtime/Async/FonepayAsync.cs.meta

@@ -0,0 +1,2 @@
+fileFormatVersion: 2
+guid: e222c5804d46c4c138b5a413587344f4

Packages/com.darkmattergameproduction.com.darkmatter.fonepay-unity/Runtime/Async/FonepayAsyncBridge.cs

@@ -0,0 +1,27 @@
+using System.Threading;
+using System.Threading.Tasks;
+
+#if UNITASK_SUPPORT
+using Cysharp.Threading.Tasks;
+#endif
+
+namespace Darkmatter.Fonepay
+{
+    internal static class FonepayAsyncBridge
+    {
+#if UNITASK_SUPPORT
+        internal static FonepayAsync<T> Wrap<T>(Task<T> task, CancellationToken ct = default)
+            => new FonepayAsync<T>(task.AsUniTask().AttachExternalCancellation(ct));
+
+        internal static FonepayAsync Wrap(Task task, CancellationToken ct = default)
+            => new FonepayAsync(task.AsUniTask().AttachExternalCancellation(ct));
+#else
+        // Task is already awaitable — wrap directly, no Awaitable needed
+        internal static FonepayAsync<T> Wrap<T>(Task<T> task, CancellationToken ct = default)
+            => new FonepayAsync<T>(task);
+
+        internal static FonepayAsync Wrap(Task task, CancellationToken ct = default)
+            => new FonepayAsync(task);
+#endif
+    }
+}

Packages/com.darkmattergameproduction.com.darkmatter.fonepay-unity/Runtime/Async/FonepayAsyncBridge.cs.meta

@@ -0,0 +1,2 @@
+fileFormatVersion: 2
+guid: 778cc7d92ed1645c195685b07ca02ee1