# Conecte o Apple Pay a uma compra no Messages

Defina o comerciante, o processador de pagamento e a integração de pedidos necessários para concluir uma compra com Apple Pay em uma conversa no Messages.

## Pré-requisitos

Você precisa da configuração de Apple Pay do comerciante, da integração com processamento de pagamento compatível, do sistema de pedidos e do ambiente de testes autorizado. Use recursos de pagamento de teste para avaliação.

## 1. Conecte a configuração do comerciante

Prepare a identidade do comerciante, certificados, redes compatíveis, capacidades de pagamento e endpoints necessários para a integração. Mantenha segredos no mecanismo de credenciais padrão e configure apenas callbacks compatíveis. As [instruções de integração do Apple Pay](https://register.apple.com/resources/messages/msp-api-tutorial/applepay) da Apple definem a sessão do comerciante e o fluxo de pagamento. Use a [explicação de configuração do provedor](/explained/apple-messages/what-does-apple-pay-in-messages-need-from-a-provider) para verificar as responsabilidades de certificado, sessão e gateway.

## 2. Prepare o pedido do cliente

Recupere o item real, a quantidade, o imposto, o frete e o valor a pagar do sistema de comércio. Use a moeda e o valor publicados. Explique o que o cliente está comprando antes de abrir a interação de pagamento.

## 3. Trate a autorização do cliente

Use a experiência compatível do Apple Pay e processe as informações de pagamento resultantes pelo gateway do comerciante. A autorização do cliente e o processamento bem-sucedido são etapas distintas.

## 4. Confirme o resultado real

Leia o resultado do pagamento e do pedido. Envie uma confirmação que reflita a transação registrada, a referência do pedido e o próximo passo. Se o pagamento falhar ou permanecer incerto, explique como o cliente pode continuar.

## 5. Teste recuperação e alternativas

Exercite recusa, cancelamento, suporte de dispositivo indisponível e resposta perdida do processador. Reconcilie o pagamento original antes de tentar novamente. Use uma alternativa de checkout compatível quando necessário.

## Verifique o pedido e o pagamento juntos

Use o ambiente de testes aprovado do seu processador de pagamento e uma experiência de teste autorizada do Apple Messages. Prepare um pedido usando o valor e a moeda do sistema de comércio, conclua a revisão nativa e inspecione o resultado do processador. Confirme que o pedido registrado e a resposta do cliente se referem à mesma compra.

| Caso de teste                                                      | Ação                                                                                                       | Resultado esperado                                                           |
| ------------------------------------------------------------------ | ---------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------- |
| O cliente cancela a autorização de pagamento                       | Deixe o pedido no estado apropriado de não pago e ofereça uma continuação.                                 | Nenhuma confirmação de compra é enviada.                                     |
| O resultado do processador está pendente ou a resposta foi perdida | Consulte a tentativa de pagamento existente usando o caminho de recuperação compatível do seu processador. | A aplicação resolve a tentativa original antes de considerar outra cobrança. |
| Um pedido pago precisa de reembolso                                | Use a operação de reembolso do sistema de pagamento e registre o resultado no pedido.                      | A resposta do serviço explica o status de reembolso registrado.              |

## Solução de problemas

Se a tela de pagamento falhar, inspecione a configuração do comerciante e a configuração de callback opcional. Se o cliente autorizou mas nenhum pedido foi confirmado, inspecione o gateway e os registros de pedido antes de cobrar novamente. O canal de mensagem não liquida a transação.

## Próximos passos

- [Explore a capacidade relacionada do Apple Messages](/products/apple-messages/payments).
- [Encontre guias e respostas sobre Apple Messages](/products/apple-messages/resources).
- [Prepare sua primeira conversa completa](/products/apple-messages/getting-started).

## Related resources

- [What is Apple Messages for Business?](/explained/apple-messages/what-is-apple-messages-for-business) (answer)
- [Apple Messages for Business](/products/apple-messages) (product)
- [Integrate an Apple Messages customer journey](/docs/guides/apple-messages/api) (docs)

[Get an implementation brief](/learn/workspace?topic=apple-messages)