Tokenização

Como funciona

A tokenização refere-se a um conjunto de pontos de extremidade de API que permitem processar pagamentos com segurança sem abrir a interface de pagamento ou envolver o usuário. Principais características:

• obter a lista de contas de pagamento salvas
• fazer um pagamento usando uma conta de pagamento salva
• excluir uma conta de pagamento

As contas de pagamento são salvas nos seguintes casos:

• O pagamento é feito através da interface do Pay Station. Uma nova conta salva é adicionada se o usuário concordar em salvar seus dados de pagamento ao inseri-la.
• O Pay Station é aberto no modo de salvamento de contas de pagamento. Para habilitá-lo, passe o parâmetro settings.ui.mode ao obter o token.

Quando a conta de pagamento é salva, ela recebe um ID. Especifique esse ID na solicitação da API para fazer um pagamento sem a interação do usuário ou abrir a interface de pagamento.

Métodos de pagamento que suportam a tokenização:

• Cartões bancários
• Amazon Pay
• Skrill Digital Wallet
• PayPal
• Alipay
• GCash
• DANA
• Rabbit LINE pay
• Touch ’n Go
• Boost
• Toss
• PayPay
• Paysafecard
• TrueMoney Wallet
• Klarna

Como obtê-lo

Para usar a tokenização, implemente os pontos de extremidade para trabalhar com contas de pagamento salvas.

Pagamentos com contas de pagamento salvas

1. Obter uma lista das contas de pagamento salvas do usuário.
2. Cobre o usuário através de uma de suas contas de pagamento.
3. Processe os dados recebidos no webhook Pagamento e credite os bens virtuais adquiridos para o usuário.

Exibindo contas de pagamento salvas do seu lado

Usando a solicitação Obtém contas salvas, você pode obter dados mascarados das contas de pagamento salvas do usuário na página do pedido.

Para armazenar dados mascarados de contas de pagamento salvas do seu lado e mantê-los atualizadas:

1. Configure o webhook Adicionar conta de pagamento. Quando um usuário adiciona uma nova conta de pagamento, você pode salvá-la e depois sugerir que um usuário pague com ela sem abrir a interface de pagamento.
2. Configure o webhook Remover conta de pagamento.

Processando eventos da interface na página de gerenciamento de contas de pagamento salvas

Para exibir informações na página de gerenciamento de contas de pagamento salvas em tempo real, processe os seguintes eventos da interface de pagamento:

• add_saved_account — salvamento bem-sucedido de uma conta de pagamento.

Formato:

command: "add_saved_account"
data:
id: 12345678
name: "1111111111111111"
payment_method: 0001
type: "card"

• add_saved_account_error — erro ao salvar uma conta de pagamento.
• cancel_save_account — o usuário cancelou o salvamento da conta de pagamento.

Se a interface do usuário de pagamento for aberta em um iframe ou usando o script Pay Station Embed, você obterá eventos da interface de pagamento via postMessage.