flutter_pay_orc #

A Flutter plugin for orc payment.

Developed By : Jere Pious #

Getting Started #

This project is a starting point for a Flutter plug-in package, a specialized package that includes platform-specific implementation code for Android and/or iOS.

For help getting started with Flutter development, view the online documentation, which offers tutorials, samples, guidance on mobile development, and a full API reference.

The plugin project was generated without specifying the --platforms flag, no platforms are currently supported. To add platforms, run flutter create -t plugin --platforms <platforms> . in this directory. You can also find a detailed instruction on how to add platforms in the pubspec.yaml at https://flutter.cn/to/pubspec-plugin-platforms.

Steps to follow:

Step 1 : In your app, specify the environment during initialization. #

void main() {        
    FlutterPayOrc.initialize(
        merchantKey: 'your-merchant-key', // updated you merchantKey.
        merchantSecret: 'your-merchant-secret', // updated your merchantSecret.
        environment: Environment.development, // Switch to Environment.production for live.
    );    
    runApp(const MyApp());
}

Step 2 : Implement create payment on stateful widget init state and load below widget based on api response.. #

**Method name on sdk:**

Future<PayOrcPaymentResponse> createPayment(
    {required PayOrcPaymentRequest request}) async {
    try {
        final response = await _client.createPayment(request);
        configMemoryHolder.payOrcPaymentResponse = response;
        return response;
    } catch (e) {
        // Handle errors.
        throw Exception('Error during payment creation: $e');
    }
}

**To call this method on app:**

final response = await FlutterPayOrc.instance.createPayment(
    request: createPayOrcPaymentRequest(),
  );

**Method name on sdk:**

Widget startPayment({
    required BuildContext context,
    required double amount,
    required String currency,
    required Function(bool success, String? transactionId) onPaymentResult,
    }) {
        final paymentUrl = instance.configMemoryHolder.paymentUrl;
        return PayOrcWebView(
        paymentUrl: paymentUrl!,
        onPaymentResult: onPaymentResult,
    );
}

**To call this method on app:**

FlutterPayOrc.instance.startPayment(
    onPaymentResult: (success, transactionId) {
      if (success) {
        ScaffoldMessenger.of(context).showSnackBar(
          SnackBar(
              content: Text(
                  'Payment successful. Transaction ID: $transactionId')),
        );
        Navigator.pop(context);
      } else {
        ScaffoldMessenger.of(context).showSnackBar(
          const SnackBar(content: Text('Payment failed.')),
        );
      }
    },
  )

Step 3 : Implement createPaymentWithWidget on widget will auto push on view. #

**Method name on sdk:**

Future<void> createPaymentWithWidget({
    required BuildContext context,
    required PayOrcPaymentRequest request,
    required Function(bool success, String? transactionId) onPaymentResult,
    }) async {
        try {
            final response = await _client.createPayment(request);
            configMemoryHolder.payOrcPaymentResponse = response;
            final paymentUrl =
            instance.configMemoryHolder.payOrcPaymentResponse?.iframeLink;
            Navigator.of(context).push(MaterialPageRoute(
            builder: (context) => PayOrcWebView(
            paymentUrl: paymentUrl!,
            onPaymentResult: onPaymentResult,
            )));
        } catch (e) {
            // Handle errors.
            throw Exception('Error during payment creation: $e');
        }
}

**To call this method on app:**

await FlutterPayOrc.instance.createPaymentWithWidget(context: context, request: createPayOrcPaymentRequest(), onPaymentResult: (success, transactionId) {
  if (success) {
    ScaffoldMessenger.of(context).showSnackBar(
      SnackBar(
          content: Text(
              'Payment successful. Transaction ID: $transactionId')),
    );
    Navigator.pop(context);
  } else {
    ScaffoldMessenger.of(context).showSnackBar(
      const SnackBar(content: Text('Payment failed.')),
    );
  }
}, onLoadingResult: (bool success) {  });

Step 4 : payment request object reference. #

final requestData = PayOrcPaymentRequest(
        data: Data(
            className: "ECOM",
            action: "SALE",
            captureMethod: "MANUAL",
            paymentToken: "",
            orderDetails: OrderDetails(
            mOrderId: "1234",
            amount: "100",
            convenienceFee: "0",
            quantity: "2",
            currency: "AED",
            description: "",
        ),
        customerDetails: CustomerDetails(
            mCustomerId: "123",
            name: "John Doe",
            email: "pawan@payorc.com",
            mobile: "987654321",
            code: "971",
        ),
        billingDetails: BillingDetails(
            addressLine1: "address 1",
            addressLine2: "address 2",
            city: "Amarpur",
            province: "Bihar",
            country: "IN",
            pin: "482008",
        ),
        shippingDetails: ShippingDetails(
            shippingName: "Pawan Kushwaha",
            shippingEmail: "",
            shippingCode: "91",
            shippingMobile: "9876543210",
            addressLine1: "address 1",
            addressLine2: "address 2",
            city: "Jabalpur",
            province: "Madhya Pradesh",
            country: "IN",
            pin: "482005",
            locationPin: "https://location/somepoint",
            shippingCurrency: "AED",
            shippingAmount: "10",
        ),
        urls: Urls(
            success: "",
            cancel: "",
            failure: "",
        ),
    ),
);

Step 5 : To fetch payment transaction status use p_order_id from create payment response. #

**Method name on sdk:**

Future<PayOrcPaymentTransactionResponse> fetchPaymentTransaction(
    {required String orderId}) async {
    try {
        final response = await _client.fetchPaymentTransaction(orderId);
        configMemoryHolder.payOrcPaymentTransactionResponse = response;
        return response;
    } catch (e) {
        // Handle errors.
        throw Exception('Error during payment creation: $e');
    }
}

**To call this method on app:**

FlutterPayOrc.instance.startPayment(
    onPaymentResult: (success, transactionId) async {
      if (success) {
        await FlutterPayOrc.instance.fetchPaymentTransaction(orderId: FlutterPayOrc.instance.configMemoryHolder.payOrcPaymentResponse!.pOrderId.toString());
        ScaffoldMessenger.of(context).showSnackBar(
          SnackBar(
              content: Text(
                  'Payment successful. Transaction ID: $transactionId')),
        );
        Navigator.pop(context);
      } else {
        ScaffoldMessenger.of(context).showSnackBar(
          const SnackBar(content: Text('Payment failed.')),
        );
      }
    },
  )

Step 6 : To clear data call following method. #

**Method name on sdk:**

void clearData() {
    instance.configMemoryHolder = ConfigMemoryHolder();
    preferenceHelper.clear();
}

**To call this method on app:**

FlutterPayOrc.instance.clearData();