නයිජීරියාව සහ අෆ්රිකානු වෙළඳපලේ වැඩ කරන බොහෝ සංවර්ධකයින්ට Paystack හා Flutterwave දෙකම එක්ක එකවර සම්බන්ධ වීමට අවශ්ය වේ. ඒකට වාරික රේඛාව, වෙබ්හුක් සත්යාපනය, මුදලේ ඒකක ව්යාකූලතා වැනි ගැටළු නැවත නැවත ලියන්න වෙයි.
මෙම පනස් වාරික කේතය එක් එක් ව්යාපෘතියකට පිටපත් කරගැනීමේ අධික පීඩනය නිසා, එකවර දෙකම එකතු කරන SDK එකක් අවශ්ය බවට හිතා ගත්තා. එම නිසා pay‑kit නමින් නව TypeScript SDK එක නිර්මාණය කර, GitHub හි විවෘත කේතයක් ලෙස මුදල් ගත කර ඇත.
pay‑kit එකේ මූලික අදහස තනි API එකක් පමණක් භාවිතා කර, පසුබැසි සේවාදායකයා (Paystack හෝ Flutterwave) වෙනස් කරගත හැකි බවයි. createPayClient මගින් provider, secret key වැනි තොරතුරු දෙයි; මුදල් පරිමාණය කෝබෝ/සෙන්ට් වශයෙන් (Stripe‑ශෛලිය) ලබා දෙන නිසා ගැටළු අවම වේ.
SDK එකේ initialize, verify, refund, transfer, resolveAccount, listBanks, getBalances, listTransactions වැනි ක්රියාකාරකම් එකම ආකාරයෙන් සපයයි. එමෙන්ම fallback ක්රමයත් ඇත – Paystack අස්ථානගත වුවහොත්, කේතය වෙනස් නොකර Flutterwave වෙත මාරු වේ. තවත් mock provider එකක් ද ඇත, එය API යතුරු අවශ්ය නොවේ; CI/CD පරිසරයේ පරීක්ෂා කිරීමට ඉතා සුදුසු.
එක්තලයෙන් මුදල් ගෙවීම් පමණක් නොව, payouts (මුදල් පිටත යැවීම), sub‑account හරහා marketplace split වැනි නවීන අවශ්යතාද මෙම SDK එකින් සලසා ගත හැක.
pay‑kit තවම beta (pre‑1.0) අවස්ථාවෙහි නමුත්, සම්පූර්ණයෙන් TypeScript වලින් typed කර ඇත, unit‑test සහ sandbox පරීක්ෂා කර ඇත. GitHub README හි තහවුරු කර නොගත් විශේෂාංග පැහැදිලි කර ඇත, එබැවින් සංවර්ධකයින්ට අවශ්ය පරිදි version pin කර පරීක්ෂා කර ගත හැක.
ශ්රී ලංකාවට ඇති වැදගත්කම
සිංහල තාක්ෂණ සමාජයට මෙම SDK එකේ ප්රයෝජන විශාලයි. අපේ දේශීය fintech startups, e‑commerce වෙබ් අඩවි, සහ ගෙවීම් ඒකීකරණය අවශ්ය ඕනෑම ව්යාපාරයක් Paystack/Flutterwave වැනි ආෆ්රිකානු ගේට්වේ සමඟ සම්බන්ධ වීමට අවශ්ය කේතය අඩු කර ගත හැක. ඒමඟින්:
- කේත පරිමාව 50% කට අඩුවීම.
- බහු ගේට්වේ එකවර පරීක්ෂා කිරීමේ හැකියාව.
- CI/CD පරිසරයේ mock provider මගින් පරීක්ෂා කිරීම පහසු වීම.
- TypeScript භාවිතයෙන් දෝෂ පාලනය ඉහළ යාම.
විශේෂයෙන්, ශ්රී ලංකාවේ ඉගෙනුම් ආයතන වලට මෙය open‑source නිසා, සිසුන්ට real‑world payment integration පළපුරුද්දක් ලබා දීමට හොඳ අවස්ථාවක්.
ඔබටත් ඔබේ යෙදුමට pay‑kit එක එක්කර, අඩු කාලය තුළ බහු ගේට්වේ සම්බන්ධතා ලබා ගත හැක. ගැටළුවක් හමුවේ GitHub issue එකක් විවෘත කර, දායකත්වය ලබා දෙන්න.