Usage

TerraCore v0

PayForOrder#

After mini-app creates an order with code mini_app_order_code and value totalAmount, use below code to pay for it

Firstly, create the payment request

Android
iOS
Javascript

val paymentRequestBuilder = PaymentRequestBuilder(PaymentV2Request.Order("mini_app_order_code", totalAmount))
    .setMainMethod(
        PaymentV2Request.Payment.MainMethod(
            method = PaymentV2Request.Payment.Method.All,
            amount = totalAmount
        )
    )
.setOptions(PaymentV2Request.ExtraOptions(
    shouldShowPaymentResultScreen = true
))

Firstly, we need create PaymentRequestBuilder instance by pass PaymentOrder param.

    let builder = PaymentKit.PaymentRequestBuilder(
        order: .init(code: orderCode, amount: orderAmount)
    )

Then, we set main payment methods

builder.setMainMethod(.vnPayQRGateway(amount: methodAmount))

After that, we set loyalty info methods if needed

    if let loyaltyAmount = loyaltyAmount, loyaltyAmount > 0 {
        builder.setLoyaltyMethod(
            points: loyaltyAmount,
            amount: loyaltyAmount
        )
    }

For showing built-in payment result page, we must set shouldShowPaymentResult in UIConfig is true :

builder.setUIConfig(.init(shouldShowPaymentResult: true))

Finally, we using build() function of this builder to get a payment request for next step.

let request = builder.build()

...then pay for the order

If your mini-app uses TerraApp as well, then pass your TerraApp's appName to terraAppName
Else pass null to terraAppName

Android
iOS
Javascript

PaymentKit.payForOrder(
    context = context,
    terraAppName = "mini_app_name", // if you do not use TerraApp, pass null
    paymentRequest = paymentRequestBuilder.build(),
    callback = object : PaymentResultV2Callback {
        override fun onResult(result: PaymentV2Result) {
            val paymentResultStatus = when (result.resultCode) {
                PaymentV2Result.RESULT_CANCELED -> {
                    // process cancel result
                }
                PaymentV2Result.RESULT_FAILED -> {
                    // process failed result
                }
                PaymentV2Result.RESULT_SUCCEEDED -> {
                    // process successful result
                }
                else -> {
                    // process unknown result
                }
            }
        }
    }
)

For more detail about PaymentRequestBuilder please refer to PaymentUIRequestBuilder. The parameters are pretty similar.