Crie um pagamento em etapa única

Este guia mostra como criar um fluxo de pagamento automatizado que reduz a interação do usuário. Você pré-configura os parâmetros de pagamento e pula as telas de seleção manual. Com um pagamento em etapa única, o terminal processa a transação rapidamente, com o mínimo de toques do usuário.

Antes de começar

Antes de começar, confirme que você tem:

• Leitura de como executar uma chamada de Polling (getnet://payment/v1/polling) antes de iniciar a transação, para garantir que não há transações pendentes nem processos travados.
• Getnet payment app instalado no terminal Android.
• Um callerId único para correlacionar a requisição com a resposta.

Passo 1: configure e envie o Intent de pagamento

Para criar um fluxo em etapa única, configure o Intent com todos os parâmetros obrigatórios e as flags de automação. A tabela abaixo descreve todos os parâmetros que você pode usar:

Veja um exemplo básico com os parâmetros obrigatórios:

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)

Passo 2: trate a resposta

O terminal retorna a resposta via onActivityResult. Verifique o campo result para confirmar o sucesso:

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
            }
        }
    }
}

Parâmetros de resposta

A resposta do terminal inclui os seguintes campos principais:

Próximos passos

Depois de criar um pagamento com sucesso, você pode explorar:

• Crie um pagamento parcelado - processe pagamentos com cartão de crédito em planos de parcelamento
• Estratégia de cálculo de juros - entenda os modos de operação para o cálculo de parcelas
• Reembolso e cancelamento - reverta ou cancele transações anteriores
• Responsabilidade de impressão - trate a impressão personalizada de comprovantes na sua aplicação
• Códigos de resultado e estruturas de dados - lista completa dos códigos de status da transação