Show UI

TerraCore v0

Usage#

iOS
Android
Flutter

Finally we just call as below to start new transaction

// start activity result
//if using activity
paymentGateway.payWith(yourActivity, paymentRequestBuilder.build())

//if using fragment
paymentGateway.payWith(yourFragment, paymentRequestBuilder.build())

Handle payment result#

After payment, the PaymentActivity will be return the result in onActivityResult with the following data:

requestCode: PaymentActivity.RC_PAYMENT
resultCode:

PaymentActivity.RESULT_CANCELED: when use cancels payment process: press Cancel button, ...
PaymentActivity.RESULT_SUCCEEDED: when payment process is succeeded
PaymentActivity.RESULT_FAILED: when payment process is failed or activity is stopped and received a Activity.RESULT_CANCELED from system.

data: a nullable PaymentResult object which depends on result

override fun onActivityResult(requestCode: Int, resultCode: Int, data: Intent?) {
    when (requestCode) {
        PaymentActivity.RC_PAYMENT -> {
            when (resultCode) {
                PaymentActivity.RESULT_CANCELED -> {
                // Payment is canceled
                }
                PaymentActivity.RESULT_FAILED -> {
                    val result = data?.getParcelableExtra<PaymentResult>(PaymentActivity.PAYMENT_RESULT_KEY)
                // TODO: Payment is failed
                }
                PaymentActivity.RESULT_SUCCEEDED -> {
                    val result = data?.getParcelableExtra<PaymentResult>(PaymentActivity.PAYMENT_RESULT_KEY)
                // TODO: Payment is succeeded
                }
            }
        }
        else -> super.onActivityResult(requestCode, resultCode, data)
    }
}

Notes:

For using VNPayEWallet method:

Download sdkwallet_release_x_x.x.x.aar file of library
Put it in libs folder
Import sdkwallet library in build.gradle file

implementation(name: 'sdkwallet_release_x_x.x.x', ext: 'aar')

Add tools:replace="label,allowBackup,android:theme" to <application> tag in AndroidManifest.xml file

Note: Currently, sdkwallet has only allowed running on the emulator. Please use real device for testing this feature.

After generating paymentUIRequest, we pass it through payWith:request:delegate function for getting UI

    do {
        try TerraPaymentUI.getInstance(by: terraApp)?.payWith(
            request: request,
            delegate: self
        )
    } catch {
        print(error)
    }

Handle payment result#

We need conform protocol AIOPaymentUIDelegate for getting result like below

    extension PaymentWithLoyaltyViewController: AIOPaymentUIDelegate {
        func onPaymentCancel() {
            // handle payment cancel event
        }
        
        func onPaymentUIResult(_ result: AIOPaymentUIResult) {
            switch result.paymentResult {
            case .success(let transactionResult):
                // handle success event
                
            case .failure(let error, let transactionResult):
                // handle failure event

            @unknown default:
                ()
            }
        }
    }

Note#

In case we don't set an online method, we will process payment by using only loyalty method. If we don't set both of methods, an error will occur.
For using VNPayEWallet method:
- Copy bundle resource `VnpayWalletSDKBundleResouce.bundle` to main bundle.
- A bundleID must be provided to Terra team.
- Currently, this method will not work on simulator.
For more details and resources, please contact the terra team.
For using VNPayQRReversal method or using download QRCode function of VNPayQRGateway + VNPayQRMMS pages, we need add Photo and Camera permissions in Info.plist file.
Disable App transport security settings if needed

<key>NSAppTransportSecurity</key>
<dict>
  <!--Include to allow all connections (DANGER)-->
  <key>NSAllowsArbitraryLoads</key>
      <true/>
</dict>

After generating paymentUIRequest

   final paymentResult = await terraPayment.payWith(paymentUIRequest);

Handle payment result#

    String message = "";
    switch (paymentResult.code) {
      case PaymentUIResultCode.success:
        message = "Payment successful";
        break;
      case PaymentUIResultCode.failure:
        message = "Payment failed: " + (paymentResult.message ?? "");
        break;
      case PaymentUIResultCode.cancelled:
        message = "Payment cancelled";
        break;
    }

Notes For using VNPayEWallet method: Please follow this Installation guide for Flutter.

References#

PaymentError