Apple Pay

Tenha em mente:

  • O pagamento via Apple Pay só está disponível nos dispositivos suportados.
  • O SDK somente verifica que o pagamento pode ser feito no dispositivo do usuário e envia os dados necessários. O pagamento é processado então em uma aba externa: https://secure.xsolla.com/paystation4/payment/external-pages/apple-pay.
  • Por conveniência, o componente psdk-apple-pay é incluído no componente psdk-submit-button.
Amostra de implementação
Consulte uma amostra detalhada no GitHub.

Como configurar

Para usar a Headless checkout para aceitar pagamentos via Apple Pay:

  1. Adicione a manipulação do evento show_fields para a exibição de campos adicionais.
Exemplo:
Copy
Full screen
Small screen
1headlessCheckout.form.onNextAction((nextAction) => {
2  switch (nextAction.type) {
3    case 'show_fields':
4      this.handleShowFieldsAction(nextAction);
5  }
6});
  1. Adicione o componente psdk-payment-form à marcação HTML da interface de pagamento para exibir campos adicionais.
Exemplo:
Copy
Full screen
Small screen
1<psdk-payment-form></psdk-payment-form>
2<psdk-submit-button text="Pay" />

Pagamentos com um clique

O pagamento com um clique permite que os usuários paguem com a Apple Pay, um método de pagamento nativo, familiar e seguro nos dispositivos suportados. Para configurar o pagamento com um clique:

  1. Crie uma solicitação para habilitar essa opção. Para fazer isso:

    a. Abra sua Conta de Distribuidor e vá para a seção Support Hub.

    b. Clique em Submit request.

    c. Na janela que surgir, preencha os seguintes campos:

    • Summary. Por exemplo, a configuração do pagamento com um clique via Apple Pay.
    • Description. Especifique o domínio usado para abrir a interface de pagamento, como amazing.store.com.
    • Project ID. Selecione um ID de projeto na lista suspensa. Se você quiser configurar a opção de pagamento com um clique para múltiplos projetos, especifique os IDs deles no campo Description.

    d. Clique em Send.

  2. Espere pelo arquivo de associação do domínio. Essa etapa é realizada pela Xsolla:
    1. A Xsolla cadastra seu domínio com a Apple.
    2. A Xsolla recebe o arquivo de associação do domínio da Apple.
    3. A Xsolla envia um e-mail a você com o arquivo de associação do domínio e fornece instruções sobre aonde deve enviá-lo.
  3. Atualize o script de inicialização do SDK conforme exibido abaixo:
Copy
Full screen
Small screen
1const config: InitialOptions = {
2  isWebview: false,
3  theme: 'default',
4  language: parameters.language,
5  topLevelDomain: 'amazing.store.com',
6  isApplePayInstantFlowEnabled: true
7};
8
9await initHeadlessCheckoutLib(config);
  1. Responda ao e-mail da Xsolla e confirme que você enviou o arquivo de associação do domínio ao local especificado e atualizou o script de inicialização do SDK.
  2. Aguarde a confirmação da Xsolla de que o pagamento com um clique foi ativado com sucesso no seu projeto.
Observação
Consulte as instruções para obter informações detalhadas sobre testes da Apple Pay no modo sandbox.
Este artigo foi útil?
Obrigado!
Podemos melhorar alguma coisa? Mensagem
Que pena ouvir isso
Explique porque este artigo não foi útil para você. Mensagem
Obrigado pelo seu feedback!
Avaliaremos sua mensagem e a usaremos para melhorar sua experiência.
Última atualização: 18 de Julho de 2025

Encontrou um erro de texto ou digitação? Selecione o texto e pressione Ctrl+Enter.

Relatar um problema
Nós sempre avaliamos nossos conteúdos. Seu feedback nos ajuda a melhorá-los.
Forneça um e-mail para que possamos responder
Obrigado pelo seu feedback!
Não conseguimos enviar seu feedback
Tente novamente mais tarde ou contate-nos via doc_feedback@xsolla.com.