Pagamento

Enviar um pagamento

Para fazer o pagamento, é preciso criar uma Intent, adicionando as informações como parâmetros dessa Intent.

val uriBuilder = Uri.Builder()
uriBuilder.authority("pay")
uriBuilder.scheme("payment-app")
uriBuilder.appendQueryParameter("return_scheme", "return_scheme")
uriBuilder.appendQueryParameter("amount", "amount")
uriBuilder.appendQueryParameter("editable_amount", "0/1")
uriBuilder.appendQueryParameter("transaction_type", "debit")
uriBuilder.appendQueryParameter("installment_type", "none")
uriBuilder.appendQueryParameter("installment_count", "2")
uriBuilder.appendQueryParameter("order_id", "123")

val intent = Intent(Intent.ACTION_VIEW)
intent.addFlags(Intent.FLAG_ACTIVITY_NEW_TASK)
intent.data = uriBuilder.build()
startActivity(intent)

Campos utilizados para envio

Todos os campos estão em formato String

Atenção

Se os campos opcionais não forem enviados via deeplink, serão solicitados no aplicativo de Pagamento.

Campo	Obrigatório?	Descrição
`amount`	Não	Valor do pagamento, em centavos. Aceita valores entre 0 e 999999999.
`transaction_type`	Não	Modalidade do pagamento: DEBIT, CREDIT, VOUCHER, INSTANT_PAYMENT e PIX. Esse campo aceita valor nulo.
`installment_type`	Não	Tipo de parcelamento: MERCHANT (parcelado sem juros), ISSUER (parcelado com juros) e NONE (à vista). Esse campo aceita valor nulo.
`installment_count`	Não	Quantidade de parcelas. Aceita valores entre 2 e 99.
`order_id`	Não	Identificador do pedido. Aceita valores até 9223372036854775807. Caso queira utilizá-lo, habilitar a funcionalidade no aplicativo de Ajustes do POS.
`editable_amount`	Não	Permite que o valor do pagamento seja editado diretamente no aplicativo de Pagamento. Valor 1 para true e 0 para false.
`return_scheme`	Sim	Determina para onde será o retorno do deeplink. Deve ser o mesmo valor configurado no lugar da variável `scheme` no AndroidManifest.

Retorno do pagamento

Para conseguir o retorno do deeplink de pagamento, pode ser utilizada a função abaixo que captura a informação que foi retornada pela Intent.

Atenção

As mensagens de erro no pagamento são enviadas como Exception, por isso é importante utilizar alguma medida que capture as Exceptions emitidas. A função abaixo é apenas um exemplo de como pode ser implementado.

override fun onNewIntent(intent: Intent?) {
    super.onNewIntent(intent)
    try {
        Log.i("onNewIntent", intent?.data.toString())
        if (intent?.data != null) {
            Toast.makeText(this, intent.data.toString(), Toast.LENGTH_LONG).show()
            Log.i("Deeplink Response", intent.data.toString())
        }
    } catch (e: Exception) {
        Toast.makeText(this, e.toString(), Toast.LENGTH_LONG).show()
        Log.e("Deeplink error", e.toString())
    }
}

chave	Descrição
cardholder_name	Nome impresso no cartão
itk	Initiator Transaction Key
atk	Authorizer Transaction Key
authorization_date_time	Data/hora da autorização
brand	Bandeira do cartão
order_id	Identificador do Pedido
authorization_code	Código da autorização da transação
installment_count	Quantidade de parcelas
pan	sequencia do PAN
type	Tipo da Transação DEBIT, CREDIT, VOUCHER, INSTANT_PAYMENT e PIX)
entry_mode	Identifica o modo de entrada do ponto de venda. (Tarja, CHIP & PIN, etc).
account_id	identificador da carteira digital
customer_wallet_provider_id	identificador do Provider da carteira digital
code	código de sucesso ou erro
transaction_qualifier	Qualificador da transação, como `Prepaid`, para indicar cartão pré-pago

Exemplos de Retorno

Pagamento feito com Debito

Sucesso
deeplinktest://pay-response?code=0&amount=100&cardholder_name=JOAO%2FSILVA&itk=PB0419AL60480-1.17.7-2278-0003&atk=37820073187607&authorization_date_time=05%2F10%2F2022%2002%3A36%3A17&brand=MASTERCARD&authorization_code=187607&installment_count=0&pan=627303****2166&type=D%C3%A9bito&entry_mode=ICC

Exemplo Erro

Encerrou o pagamento
deeplinktest://pay-response?code=2&message=Usu%C3%A1rio%20encerrou%20o%20aplicativo

1016 - Não Autorizado
"deeplinktest://pay-response?success=false&reason=1016&response_code=-6&code=-6&message=N%C3%A3o%20autorizada"

// success=false
// reason=1016
// message=N%C3%A3o%20autorizada (Não Autorizado)

Código de Erro

Transação de sucesso o retorno é 0
diferente disso é considerado como erro

Chave	Descrição
code	Código de erro
mensagem	Mensagem de erro

Jornada: Integrar por Deeplink
Etapa 4 de 11

Etapa anteriorConfiguração Próxima etapaCancelamento