Crie um pagamento pré-autorizado

Este guia mostra como processar uma transação de pré-autorização com o Getnet Payment App. A pré-autorização retém temporariamente um valor no cartão de crédito do cliente para uma captura futura. É comum em reservas de hotel ou aluguel de carros, quando o valor final pode variar.

Antes de começar

Antes de seguir os passos, você precisa de:

• Getnet Payment App instalado no terminal.
• Conhecimento dos códigos de plano de parcelamento, se aplicável.

Como funciona

Todas as ações de pré-autorização usam a URI getnet://payment/v1/pre-auth. O parâmetro operation seleciona a ação:

Passo 1: crie uma pré-autorização

Para reservar um valor no cartão do cliente, envie um Intent com operation definido como "0".

Parâmetros de requisição

O bloco de código abaixo mostra como criar uma pré-autorização:

private val REQUEST_CODE = 1001

private fun createPreAuth() {
    val intent = Intent(Intent.ACTION_VIEW, Uri.parse("getnet://payment/v1/pre-auth"))

    intent.putExtra("operation", "0") // 0 = create
    intent.putExtra("amount", "10000") // $100.00
    intent.putExtra("originalAmount", "10000")
    intent.putExtra("installments", "1")
    intent.putExtra("plan_id", "plan_emisor")
    intent.putExtra("operationMode", "0")
    intent.putExtra("skipReceipt", "true")

    startActivityForResult(intent, REQUEST_CODE)
}

Parâmetros de resposta

Veja um exemplo de tratamento da resposta de criação:

override fun onActivityResult(requestCode: Int, resultCode: Int, data: Intent?) {
    super.onActivityResult(requestCode, resultCode, data)

    if (requestCode == REQUEST_CODE && resultCode == RESULT_OK) {
        val extras = data?.extras
        val result = extras?.getString("result")

        if (result == "0") {
            // SUCCESS: store the pre-authorization identifier
            val reservationId = extras?.getString("authorizationRefCode")
            val amount = extras?.getString("amount")

            // Store authorizationRefCode - you send it as reservation_id later
            saveReservationId(reservationId)
        } else {
            val errorDetails = extras?.getString("resultDetails")
            Log.e("PreAuth", "Pre-authorization failed: $errorDetails (Code: $result)")
        }
    }
}

Guarde o authorizationRefCode retornado na resposta. Esse identificador é obrigatório para confirmar, modificar ou remover a pré-autorização. Se você não informá-lo nas operações seguintes, o valor é liberado automaticamente quando o prazo da reserva expira.

Passo 2: confirme a pré-autorização

Depois de entregar o serviço ou o produto, confirme a pré-autorização para transformar a reserva temporária em pagamento definitivo. Essa operação captura o valor e conclui a transação.

Parâmetros de requisição

private fun confirmPreAuth(reservationId: String, finalAmount: String? = null) {
    val intent = Intent(Intent.ACTION_VIEW, Uri.parse("getnet://payment/v1/pre-auth"))

    intent.putExtra("operation", "3") // 3 = confirm
    intent.putExtra("reservation_id", reservationId)

    finalAmount?.let { intent.putExtra("amount", it) }

    startActivityForResult(intent, REQUEST_CODE)
}

Confirme o sucesso verificando se result é igual a "0" em onActivityResult.

Modifique uma pré-autorização

Para atualizar o valor reservado antes da captura, envie operation definido como "1" junto com o reservation_id. Consulte Modifique um pagamento para ver o fluxo completo.

Remova uma pré-autorização

Para cancelar uma pré-autorização e liberar o valor reservado, envie operation definido como "2" junto com o reservation_id.

private fun removePreAuth(reservationId: String) {
    val intent = Intent(Intent.ACTION_VIEW, Uri.parse("getnet://payment/v1/pre-auth"))

    intent.putExtra("operation", "2") // 2 = remove
    intent.putExtra("reservation_id", reservationId)

    startActivityForResult(intent, REQUEST_CODE)
}

Consulte as pré-autorizações pendentes

Para listar as pré-autorizações pendentes, envie operation definido como "4". Você pode restringir os resultados com os parâmetros de filtro filterReservationId, filterInitialDate, filterFinalDate, filterAuthorizationCode, filterCardLastDigits e filterAllowedBrands. A resposta traz uma lista pendingAuthorizations com até as 30 pré-autorizações pendentes mais recentes. Consulte Parâmetros de deeplink.

Próximos passos

• Modifique um pagamento — atualize o valor de uma pré-autorização.
• Parâmetros de deeplink — campos completos de requisição e resposta da pré-autorização.
• Códigos de resultado e estruturas de dados — lista completa dos códigos de status.