Create a Single-Step Payment

This guide shows you how to create an automated payment flow that minimizes user interaction by pre-configuring payment parameters and bypassing manual selection screens. With a single-step payment, the terminal processes the transaction quickly with minimal taps from the user.

Before you begin

Before starting, ensure you have:

• Read how to perform a Polling call (getnet://payment/v1/polling) before initiating the transaction to ensure there are no pending transactions or locked processes.
• Getnet Payment App installed on the Android terminal.
• A unique callerId to correlate the request with the response.

Step 1: Configure and send the payment Intent

To create a single-step flow, configure the Intent with all required parameters and automation flags. The following table describes all parameters you can use:

Here’s a basic example with the required parameters:

private val REQUEST_CODE = 1001

val intent = Intent(Intent.ACTION_VIEW, Uri.parse("getnet://payment/v1/payment"))
intent.putExtra("amount", "10000")              // $100.00
intent.putExtra("originalAmount", "10000")
intent.putExtra("receiptCode", "987654")
intent.putExtra("callerId", "req_001")

startActivityForResult(intent, REQUEST_CODE)

Step 2: Handle the response

The terminal returns the response via onActivityResult. Check the result field to confirm success:

override fun onActivityResult(requestCode: Int, resultCode: Int, data: Intent?) {
    super.onActivityResult(requestCode, resultCode, data)
    
    if (requestCode == REQUEST_CODE && resultCode == RESULT_OK) {
        val result = data?.extras?.getString("result")
        
        when (result) {
            "0" -> {
                // Transaction approved
                val nsu = data?.extras?.getString("nsu")
                val authCode = data?.extras?.getString("authorizationCode")
                val amount = data?.extras?.getString("amount")
                // Handle success
            }
            else -> {
                // Transaction failed or cancelled
                val resultDetails = data?.extras?.getString("resultDetails")
                // Handle error
            }
        }
    }
}

Response Parameters

The terminal response includes the following key fields:

Next steps

After successfully creating a payment, you may want to explore:

• Create Payments with Installments - Process credit card payments with installment plans
• Interest Calculation Strategy - Understand operation modes for installment calculations
• Process Refunds and Cancellations - Reverse or cancel previous transactions
• Printing Responsibility - Handle custom receipt printing in your application
• Result Codes Reference - Complete list of transaction status codes