Introduction

Astro is Neptune Fintech's OpenWave-compliant payment gateway. The SDKs in this documentation let you integrate Astro payments into any platform.

SDK Matrix

SDK	Package / Module	Runtime	Install
TypeScript	@neptune.fintech/astro-sdk	Node.js 18+	npm i @neptune.fintech/astro-sdk
Web Drop-in	@neptune.fintech/astro-web	Browser	CDN or npm i @neptune.fintech/astro-web
React	@neptune.fintech/astro-react	React 18+	npm i @neptune.fintech/astro-react
Flutter	astro_sdk	Flutter 3.10+ / Dart 3+	pubspec.yaml
Kotlin	ly.neptune.astro:astro-kotlin	JVM 17+	build.gradle.kts
Swift	AstroSDK	iOS 15+ / macOS 12+	Swift Package Manager

Choose the right SDK

• Backend / server-side — Use TypeScript (Node) or Kotlin (JVM/Spring)
• Checkout widget — Use Web Drop-in (no framework) or React (React app)
• Mobile app — Use Flutter (cross-platform) or Swift (iOS native)

Core Flow

1. Merchant backend creates a PaymentSession   →  POST /payments/sessions
2. Customer is redirected to checkoutUrl       →  Astro checkout UI
3. Customer authenticates and pays             →  Astro debit + LyPay routing
4. Astro fires payment.completed webhook       →  Your webhook endpoint
5. Merchant fulfils the order                  →  Done ✅

Gateway URL

Base URL: https://astro.neptune.ly/api/v1

Next Steps

• Authentication →
• TypeScript SDK →
• Flutter SDK →