Iniciar o fluxo de pagamento

Para oferecer uma experiência fluida no seu aplicativo, nosso SDK facilita a inicialização do fluxo de pagamento através da classe PaymentFlow. Desta forma:

          
val paymentFlow = MPManager.paymentFlow

val amount = "2.0"
val description = "Payment description"
val intentSuccess = paymentFlow.buildCallbackUri(
   callback = "mercadopago://smart_integrations/payment_result",
   methodCallback = "success",
   metadata = hashMapOf("message" to "testSuccess"),
   appID = "demo.app"
)
val intentError = paymentFlow.buildCallbackUri(
   callback = "mercadopago://smart_integrations/payment_result",
   methodCallback = "error",
   metadata = hashMapOf("message" to "testError"),
   appID = "demo.app"
)

val paymentFlowData = PaymentFlowData(
   amount = amount,
   description = description,
   intentSuccess = intentSuccess,
   intentError = intentError,
   paymentMethod = PaymentMethod.CREDIT_CARD.name,
   installments = 6
)
paymentFlow.launchPaymentFlowActivity(
   paymentFlowData = paymentFlowData,
   context = context
) { response ->
   response.doIfSuccess { message ->
       // Gerenciamento bem-sucedido usando uma mensagem
   }.doIfError { error ->
       // Gerenciamento do erro
   }
}

          
final PaymentFlow paymentFlow = MPManager.INSTANCE.getPaymentFlow();

final HashMap<String, String> successMetadata = new HashMap<>();
successMetadata.put("success", "testSuccess");

final HashMap<String, String> errorMetadata = new HashMap<>();
successMetadata.put("message", "testError");

final String amount = "2.0";
final String description = "Payment description";
final Uri intentSuccess = paymentFlow.buildCallbackUri(
   "mercadopago://smart_integrations/payment_result",
   "success",
   successMetadata,
   "demo.app"
);
final Uri intentError = paymentFlow.buildCallbackUri(
   "mercadopago://smart_integrations/payment_result",
   "error",
   errorMetadata,
   "demo.app"
);

final PaymentFlowData paymentFlowData = new PaymentFlowData(
   amount,
   description,
   intentSuccess,
   intentError,
   PaymentMethod.CREDIT_CARD.name(),
   6
);

final Function1<MPResponse<String>, Unit> callback = (final MPResponse<String> response) -> {
 if (response.getStatus() == ResponseStatus.SUCCESS) {
   // Gerenciamento bem-sucedido usando uma mensagem
 } else {
   // Gerenciamento do erro
 }
 return Unit.INSTANCE;
};

paymentFlow.launchPaymentFlowActivity(paymentFlowData, context, callback);

Campo	Descrição
amount (String)	O valor usado para iniciar o fluxo de pagamento.
description (String)	A descrição usada para iniciar o fluxo de pagamento. Seu uso é opcional.
intentSuccess (Uri)	URI que chama a tela de sucesso. É usada para formar um deeplink que envia a atividade de sucesso.
intentError (Uri)	URI que chama a tela de erro. É usada para formar um deeplink que envia a atividade de erro.
paymentMethod (String)	O meio de pagamento para realizar a transação. Seu uso é opcional.
installments (Int)	O número de parcelas usado para iniciar o fluxo de pagamento. Está disponível apenas para o Brasil e seu uso é opcional.
launchPaymentFlowActivity	Esse método inicia o fluxo de pagamento usando o aplicativo SmartPOS.
paymentFlowData (PaymentFlowData)	Modelo de dados necessário para a abertura do fluxo.
context (Context)	Contexto de onde será iniciado o fluxo.
Callback (MPResponse<String> -> Unit)	Proporciona o resultado da abertura do fluxo de pagamento.

Construir uma URI para abertura do fluxo de pagamento

A função buildCallbackUri está desenhada para construir uma URI válida que permita abrir uma atividade específica, com base na estratégia do deeplink. Para acessar, use a instância PaymentFlow através do objeto MPManager.

Atenção

Configure corretamente o deeplink no seu AndroidManifest para que a atividade correspondente direcione a chamada.

Confira como implementar essa funcionalidade:

          
val paymentFlow = MPManager.paymentFlow

val uriResult = paymentFlow.buildCallbackUri(
   callback = "tuHost://tuApp/result",
   methodCallback = "error",
   metadata = hashMapOf("message" to "result"),
   appID = "demo.app"
)

          
final PaymentFlow paymentFlow = MPManager.INSTANCE.getPaymentFlow();

final HashMap<String, String> resultMetadata = new HashMap<>();
resultMetadata.put("message", "result");

final Uri uriResult = paymentFlow.buildCallbackUri(
   "tuHost://tuApp/result",
   "error",
   resultMetadata,
   "demo.app"
);

Campo	Descrição
callback (String)	O valor da URI para chamar o deeplink. Exemplo: `tuHost://tuApp/prueba`.
methodCallback (String)	Identifica se a URI é para um caso de sucesso, erro ou outra resposta personalizada.
metadata (HashMap<String, String>)	Campo opcional para enviar informação à tela de resposta, caso seja necessário mostrar detalhes adicionais, como o nome do cliente ou o resumo dos produtos comprados.
appID (String)	Identificador do aplicativo principal. Usamos o nome do pacote. Exemplo: `com.tuempresa.tuapp`.
Uri	A URI definida com a informação proporcionada.

Obter o resultado do pagamento

A função parseResponse da classe PaymentFlow é usada para receber o resultado do fluxo de pagamento, sendo entregue na forma de objeto PaymentResponse pronto para a sua manipulação. Nesse processo, as seguintes informações são proporcionadas:

Meio de pagamento usado;
Referência de pagamento;
Data de criação;
Valor do pagamento;
Número de série da maquininha;
Bandeira do cartão;
Quantidade de parcelas;
Últimos quatro dígitos do cartão;
Qualquer erro associado à transação.

Confira como implementar esta funcionalidade:

          
intent.data?.let { data ->
   val response = paymentFlow.parseResponse(data)
   if (response.paymentReference.isNotEmpty()) {
       // Gerenciamento de pagamento com um resultado de sucesso
   } else {
       // Gerenciamento de pagamento com um resultado de erro
   }
}

          
final PaymentFlow paymentFlow = MPManager.INSTANCE.getPaymentFlow();

final Uri resultUri = getIntent().getData();
final PaymentResponse response = paymentFlow.parseResponse(resultUri);

if (!response.getPaymentReference().isEmpty()) {
 // Gerenciamento de pagamento com um resultado de sucesso
} else {
 // Gerenciamento de pagamento com um resultado de erro
}

Campo	Descrição
response (Uri)	A resposta recebida da SmartPOS. Para encontrá-la, use `intent.data` da Activity encarregada de abrir o deeplink configurado dentro da função `buildCallbackUri`.
PaymentResponse	Objeto que contém detalhes da transação. Se a resposta é nula, é devolvido um objeto `PaymentResponse` com um `paymentStatusError`.
paymentMethod	Meio de pagamento usado para fazer a transação. Exemplos: crédito, débito, código QR, link de pagamento etc.
paymentReference	Número identificador único da transação.
paymentCreationDate	Data de criação da transação.
paymentAmount	Valor pago.
paymentSnDevice	Número de série da maquininha em que a transação foi feita.
paymentBrandName	Nome do usuário registrado na maquininha.
aymentInstallments	Número de parcelas que a pessoa selecionou ao fazer o pagamento.
paymentLastFourDigits	Últimos quatro dígitos do cartão usado no pagamento.
paymentStatusError	Campo para registrar problemas e erros da transação.