Iniciar o fluxo de pagamento

Neste momento, os métodos de pagamento disponíveis são: cartões de crédito e débito e link de pagamento.

Existem três formas de começar um fluxo de pagamento, dependendo do callback de resposta a ser utilizado. A função launchPaymentFlow permite indicar URLs como callbacks e funções JavaScript nativas para receber uma notificação com o resultado do fluxo de pagamento. Você também pode usá-la para iniciar o fluxo de pagamento com um método de pagamento específico.

Confira os exemplos de cada implementação a seguir.

Uso básico

Esta é a implementação básica, em que não se configura nenhum callback customizado para notificar o resultado. Nesse caso, é necessário ouvir os eventos globais que notificam o resultado do pagamento para validar o comportamento do aplicativo ao concluir o fluxo. Neste exemplo, o fluxo de pagamento é iniciado com o valor de R$20 e sem callback customizado.

 launchPaymentFlow(20.0)

Neste exemplo, o fluxo é iniciado com o valor de R$35, com o cartão de crédito selecionado como forma de pagamento e sem callback customizado.

launchPaymentMethod(35.0, "credit")

Iniciar com URL callbacks

Permite indicar uma URL de resposta bem-sucedida quando o fluxo de pagamento foi bem-sucedido e uma URL de resposta de erro para quando ocorreu um problema ou cancelamento.

Exemplo:

launchPaymentFlow(15.50, null,'congrats.html','error.html')

No exemplo, o fluxo é lançado com valor de R$ 15,50 e é indicado com um caminho relativo em caso de sucesso (congrats.html), e um caminho relativo em caso de erro (error.html). O valor null indica que nenhum metadado está sendo transmitido como dado adicional.

Observe que esses arquivos de URL devem existir dentro do aplicativo da web para que o callback de resposta funcione corretamente. No caso do exemplo, eles devem estar localizados na raiz do aplicativo.

Iniciar com funções nativas JavaScript

Permite indicar funções nativas do JavaScript , como callbacks de resposta com o resultado do fluxo de pagamento. Para isso, você deve ter uma função global acessível a partir do componente janela do JS DOM. Essas funções devem ser prefixadas com callback_ para que o sistema saiba que uma função JavaScript está sendo passada para ele como um callback.

launchPaymentFlow(15.50, null,
'callback_payment_success', 'callback_payment_error')

Iniciar método de pagamento

Para iniciar o fluxo com um método de pagamento específico, execute a função launchPaymentMethod.

Assim:

launchPaymentMethod(amount, paymentMethod
encodeURIComponent({"attr":"123"}), 'congrats.html', 'error.html')

Para obter as variantes de métodos de pagamento permitidas, é necessário chamar o comando getPaymentMethods.

Iniciar pagamento com config definido (novo)

Você deve criar uma instância de PaymentConfigBuilder a fim de definir uma configuração necessária. Em seguida, use o método launchPayment com esta configuração para iniciar o fluxo de pagamento.

Desta forma:

var config = new PaymentConfigBuilder();
config.setAmount(10.0);
config.setPaymentMethod("credit");
config.setMetadata(encodeURIComponent({"attr":"123"});
config.setCallbackSuccess("congrats.html");
config.setCallbackError("error.html");

launchPayment(config);

Parâmetros de configuração:

Parâmetro	Tipo	Obrigatório	Valores possíveis	Descrição
Amount	number	true	0.01 <= n < 50000	Define o valor a ser cobrado.
PaymentMethod	string	true	crédito, débito, qr e link	Indica se o fluxo de cobrança é iniciado diretamente para um meio de pagamento sem passar pelo seletor de meio de pagamento.
metadata	string	no	objeto Json como uma string	Informações adicionais em formato JSON com codificação de URL e que serão retornadas no callback quando o fluxo de pagamento for finalizado.
CallbackSuccess	string	no	paths	Define um callback quando o pagamento for concluído com sucesso. Esse callback pode ser um caminho relativo ou um nome de função.
CallbackError	string	no	paths	Define um callback quando o pagamento não é concluído por qualquer motivo. Esse callback pode ser um caminho relativo ou um nome de função.