ntt_atom_flutter 2.0.0

A Flutter SDK for integrating NTT Atom Pay, enabling seamless payment processing with secure and efficient transactions.

NTT Atom Pay Flutter SDK

This Package Provides Simpler Integration For NTT Atom pay

Example:

import 'dart:developer';

import 'package:flutter/material.dart';
import 'package:ntt_atom_flutter/ntt_atom_flutter.dart';

void main() {
  runApp(const MainApp());
}

class MainApp extends StatelessWidget {
  const MainApp({super.key});

  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      navigatorObservers: [AtomSDK.navigatorObserver],
      home: Home(),
    );
  }
}

class Home extends StatelessWidget {
  const Home({super.key});

  @override
  Widget build(BuildContext context) {
    return Scaffold(
      body: Center(
        child: ElevatedButton(
          onPressed: () {
            AtomSDK.checkOut(
              sdkOptions: AtomPaymentOptions(
                login: '317157',
                password: 'Test@123',
                prodid: 'NSE',
                requestHashKey: 'KEY1234567234',
                responseHashKey: 'KEYRESP123657234',
                requestEncryptionKey: 'A4476C2062FFA58980DC8F79EB6A799E',
                responseDecryptionKey: '75AEF0FA1B94B3C10D4F5B268F757F11',
                txncurr: 'INR',
                amount: '400',
                merchType: 'R',
                mccCode: '5499',
                clientcode: 'NAVIN',
                address: 'mumbai',
                custFirstName: 'test',
                custLastName: 'test',
                email: '[e-mail]',
                mobile: '8888888888',
                custacc: '639827',
                udf1: 'udf1',
                udf2: 'udf2',
                udf3: 'udf3',
                udf4: 'udf4',
                udf5: 'udf5',
                mode: AtomEnv.uat,
                txnid: 'test240223',
              ),
              onClose: (transactionStatus, data) {
                log(
                  "Transaction Status ${transactionStatus.name.toString()}\nTransaction Data ${data.toString()}",
                  name: "ATOM Payment Status",
                );
              },
            );
          },
          child: Text('Start Payment'),
        ),
      ),
    );
  }
}

Usage

1. add AtomSDK.atomNavigatorObserver in app navigatorObservers

     MaterialApp(
         navigatorObservers: [AtomSDK.navigatorObserver],
         home: Home(),
     )
   

2. Check Out

     AtomSDK.checkOut(
             sdkOptions: AtomPaymentOptions(
               login: '317157',
               password: 'Test@123',
               prodid: 'NSE',
               requestHashKey: 'KEY1234567234',
               responseHashKey: 'KEYRESP123657234',
               requestEncryptionKey: 'A4476C2062FFA58980DC8F79EB6A799E',
               responseDecryptionKey: '75AEF0FA1B94B3C10D4F5B268F757F11',
               txncurr: 'INR',
               amount: '400',
               merchType: 'R',
               mccCode: '5499',
               clientcode: 'NAVIN',
               address: 'mumbai',
               custFirstName: 'test',
               custLastName: 'test',
               email: '[e-mail]',
               mobile: '8888888888',
               custacc: '639827',
               udf1: 'udf1',
               udf2: 'udf2',
               udf3: 'udf3',
               udf4: 'udf4',
               udf5: 'udf5',
               mode: AtomEnv.uat,
               txnid: 'test240223',
             ),
             onClose: (transactionStatus, data) {
               log(
                 "Transaction Status ${transactionStatus.name.toString()}\nTransaction Data ${data.toString()}",
                 name: "ATOM Payment Status",
               );
             },
             onUserExitRequest: () async {
               // Optional. Called when the user tries to leave the payment
               // screen (e.g. system back button/gesture). Return `true` to
               // allow the exit (closes the SDK with AtomTransactionStatus.cancelled),
               // or `false` to keep the user on the payment screen.
               // Defaults to `true` (always allow exit) if omitted.
               return true;
             },
           );
   

Custom Return URL

By default (returnUrlConfig is null) the SDK uses its own return URL, fully parses the transaction response, and delivers a typed AtomTransactionStatus to onClose. No extra configuration is needed for this path.

If you need your backend to also receive the transaction data, set returnUrlConfig in AtomPaymentOptions:

AtomPaymentOptions(
  ...
  returnUrlConfig: AtomReturnUrlConfig(
    returnUrl: 'https://your-server.com/payment/callback',
    mode: AtomCallbackMode.forwardUnencrypted, // or forwardEncrypted / sendToServer
  ),
)

Modes

Mode	How it works	App gets status?
sendToServer	Gateway redirects the WebView straight to your URL. The app receives the raw page content as a string.	No (unknown)
forwardEncrypted	SDK captures the response at its default URL, extracts the encrypted payload from the page, POSTs it as-is (Content-Type: text/plain) to your URL, then separately decrypts it to determine the status for the app.	Yes
forwardUnencrypted	SDK captures the response at its default URL, decrypts it, POSTs the JSON (Content-Type: application/json) to your URL, then parses the status for the app.	Yes

Note: For forwardEncrypted and forwardUnencrypted, a POST failure to your server is silently ignored — the SDK status callback is always delivered.

Confirming User Exit

Pass onUserExitRequest to checkOut to intercept the user attempting to leave the payment screen (system back button/gesture):

AtomSDK.checkOut(
  sdkOptions: options,
  onClose: (transactionStatus, data) { ... },
  onUserExitRequest: () async {
    return await showDialog<bool>(
          context: context,
          builder: (context) => AlertDialog(
            title: const Text('Cancel Payment?'),
            content: const Text('Are you sure you want to exit the payment?'),
            actions: [
              TextButton(
                onPressed: () => Navigator.of(context).pop(false),
                child: const Text('No'),
              ),
              TextButton(
                onPressed: () => Navigator.of(context).pop(true),
                child: const Text('Yes'),
              ),
            ],
          ),
        ) ??
        false;
  },
);

• Return true to allow the exit — the SDK closes and calls onClose with AtomTransactionStatus.cancelled.
• Return false to keep the user on the payment screen.
• If onUserExitRequest is omitted, exit is always allowed.

Android Configuration

Add the INTERNET permission and a <queries> block to your android/app/src/main/AndroidManifest.xml. The <queries> block is required on Android 11+ (API 30+) for the OS to allow the SDK to launch UPI payment apps.

<manifest>
    <uses-permission android:name="android.permission.INTERNET" />

    <queries>
        <intent>
            <action android:name="android.intent.action.VIEW" />
            <data android:scheme="tez" />
        </intent>
        <intent>
            <action android:name="android.intent.action.VIEW" />
            <data android:scheme="phonepe" />
        </intent>
        <intent>
            <action android:name="android.intent.action.VIEW" />
            <data android:scheme="paytmmp" />
        </intent>
        <intent>
            <action android:name="android.intent.action.VIEW" />
            <data android:scheme="upi" />
        </intent>
    </queries>

    <application ...>
        ...
    </application>
</manifest>

iOS Configuration

To allow the SDK to launch UPI payment apps (Google Pay, PhonePe, Paytm) on iOS, you must declare their URL schemes in your app's Info.plist. Without this, iOS will silently block the deep link and the SDK will show a snackbar asking the user to try another payment method.

Add the following to your ios/Runner/Info.plist:

<key>LSApplicationQueriesSchemes</key>
<array>
    <string>tez</string>
    <string>phonepe</string>
    <string>paytmmp</string>
    <string>upi</string>
</array>

Contributions

Contributions are welcome! Please fork the repository and submit a pull request. For bug reports or feature requests, please open an issue on the GitHub repository.

License

ntt_atom_flutter is licensed under the MIT License. See the LICENSE file for details.