💰 EnzonaPay

Android implementation of Enzona XETID-DT-VC. Restricted and specific use case.

WARNING: Confirm Payment step use a real balance.

Screenshots

Sample library project to test the payment platform.

The first step is create the payment.

Create Payment	Payment Created

A WebView should be use to confirm the payment through ENZONA web interface.

Authenticate with Enzona	Confirm Payment

Including in your project

Gradle

allprojects  {
    repositories {
        ...
        maven { url 'https://jitpack.io' }
    }
}

Add the dependency.

dependencies {
    implementation 'com.github.jdsdhp:enzona-pay-library:$version'
}

Usage

Kotlin

After successfully creating the payment, a PayCreateResponse is received and the payment needs to be confirmed. For this, PayWebViewFragment is used passing as a parameter the response of the payment created.. This fragment is usually added through a transition.

supportFragmentManager.beginTransaction()
    .setTransition(FragmentTransaction.TRANSIT_FRAGMENT_FADE) //Optional
    .replace(R.id.container, PayWebViewFragment.newInstance(payCreateResponse))
    .commit()

Use WebViewLoadListener to listen for status changes and errors that may arise.

supportFragmentManager.addFragmentOnAttachListener { _, fragment ->
    if (fragment is PayWebViewFragment) {
        fragment.webViewLoadListener = object : WebViewLoadListener {
            override fun onLoading(createResponse: PayCreateResponse) {
                //Write you logic here.
            }

            override fun onLoadFinish(createResponse: PayCreateResponse) {
                //Write you logic here.
            }

            override fun onError(
                createResponse: PayCreateResponse,
                code: Int?,
                message: String?,
            ) {
                //Write you logic here.
            }

            override fun onPaymentCanceled(createResponse: PayCreateResponse) {
                //Write you logic here.
            }

            override fun onPaymentConfirmed(createResponse: PayCreateResponse) {
                //Write you logic here.
            }
        }
    }
}

Using BottomSheetDialog

The library can be using through a PayBottomSheetDialog implementation. TheWebViewLoadListener also works as explained above.

PayBottomSheetDialog(
    context = this,
    createResponse = payCreateResponse,
    title = "Dialog Title",
    subtitle = "Dialog Subtitle",
    shouldUseHeader = true,
).show()

Complete the Payment

When the payment has been confirmed, the PayCompleteResponse object must be used to complete the payment using the Rest API. The request will return a PayCompleteResponseWrapper with the details and current status.

License

Copyright (c) 2021 jesusd0897.

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

    http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.

inmersoft-dev/enzona-pay-library