Worldpay
Conecte Worldpay a DEUNA, configure notificações de pagamento e verifique o fluxo de pagamento completo antes de entrar no ar.
Nesta página
Conecte sua conta Worldpay no DEUNA Admin e configure Worldpay para enviar atualizações de transações para DEUNA. Ambas as etapas são importantes: salvar uma conexão adiciona suas credenciais, enquanto as notificações permitem que DEUNA reconcilie os resultados do pagamento após o processamento.
Antes de começar#
Este guia se destina a quem gerencia as conexões de pagamento do estabelecimento ou da loja. Você precisa de acesso a Conexões no DEUNA Admin e ao Worldpay Merchant Administration Interface (MAI). Se não tiver acesso a um deles, solicite ao administrador da conta.
Confirme sua conta e credenciais
Tenha o seguinte pronto para o ambiente que você está configurando:
- Uma conta Worldpay habilitada e seu ID de comerciante.
- As credenciais de conexão XML da Worldpay, incluindo os valores que a DEUNA identifica como Chave privada e Chave pública.
- As credenciais de acesso ao Worldpay MAI para configurar as notificações.
- Acesso ao estabelecimento comercial ou loja onde será criada a conexão DEUNA.
Solicite essas credenciais ao seu representante Worldpay. Confirme se as credenciais suportam a operação e o ambiente selecionados; As credenciais de login MAI e as credenciais de conexão XML têm finalidades diferentes. Insira as credenciais de conexão apenas no DEUNA Admin e mantenha-as fora do código de checkout, capturas de tela e mensagens de suporte.
Confirme a disponibilidade de pagamento
Verifique o catálogo de recursos Worldpay para seu mercado, moeda, marcas de cartão e operações necessárias. A disponibilidade depende da conta e da conexão; as descrições de recursos abaixo não significam que todos os recursos estejam habilitados para todos os comerciantes.
Confirme com a Worldpay os requisitos de adquirência local e de pessoa jurídica para cada país. Se for usar 3-D Secure, parcelamentos, carteiras ou múltiplas operações parciais, alinhe a configuração necessária com a DEUNA e a Worldpay antes de testar.
Moedas aceitas
ARS · BRL · EUR · GBP · JPY · MXN · USD
A disponibilidade de moedas depende da conta do estabelecimento na Worldpay e da conexão. Confirme quais moedas estão habilitadas para sua conta antes de testar.
1. Conecte Worldpay em DEUNA#
Abra Administrador DEUNA, selecione o estabelecimento ou a loja desejada e acesse Conexões. Em Descobrir, pesquise Worldpay e selecione Conectar.
A prévia mostra como encontrar a Worldpay, configurar as credenciais e verificar a conexão salva. Os controles são ilustrativos; configure a conta real no DEUNA Admin.
Insira as configurações de conexão
- Escolha um nome de conexão reconhecível para que sua equipe possa distingui-lo de outras contas ou ambientes.
- Selecione a moeda quando solicitada e insira as credenciais Worldpay emitidas para essa conexão.
- Escolha Compra para autorizar e solicitar captura em um fluxo de pagamento ou Autorização se você enviar uma solicitação de captura separada posteriormente.
- Configure o 3-D Secure somente após confirmar o fluxo de autenticação suportado com DEUNA. Veja Manuseio seguro 3D antes de implementar o checkout.
- Selecione Conectar e verifique se Worldpay aparece em Conexões Ativas.
| Campo DEUNA | Valor a inserir |
|---|---|
| Merchant ID | O ID do comerciante Worldpay emitido para a conexão. |
| Chave privada | A chave privada XML Worldpay. |
| Chave Pública | A senha pública XML Worldpay. |
Para pagamentos de companhias aéreas, preencha também os campos do emissor exigidos pela sua configuração: Nome do Emissor, Endereço do Emissor1, Código Postal do Emissor, Cidade do Emissor e Código do País do Emissor. Estes identificam a companhia aérea que emite o bilhete; use um código de país ISO de duas letras para seu país. Eles não substituem os dados do passageiro, passagem e itinerário enviados com pagamento.
Uma conexão em Conexões Ativas confirma que foi salva. Continue com as notificações Worldpay e um teste de pagamento antes de considerar a integração pronta.
2. Configure notificações Worldpay#
A Worldpay envia notificações à DEUNA para atualizar o estado do pagamento após processar uma autorização, captura, cancelamento ou reembolso. Seu backend recebe atualizações por uma configuração separada de webhooks da DEUNA. Configure os dois caminhos quando a integração precisar de atualizações assíncronas.
Veja Notificações de status de pagamento DEUNA para a configuração do lado do comerciante.
Defina o endereço de notificação
Em Worldpay MAI, abra Integration → Merchant Channel. No http linha, conjunto Active para Yes, definir Method para POSTe insira o endereço de notificação do ambiente correspondente.
| Meio Ambiente | Endereço de notificação Worldpay |
|---|---|
| Caixa de areia | https://api.sandbox.deuna.io/transactions/webhooks/payconnect/payment-processors/worldpay |
| Produção | https://api.deuna.io/transactions/webhooks/payconnect/payment-processors/worldpay |
Confirme o endereço com DEUNA para sua conexão antes de salvá-lo. Worldpay chama esse endereço; seu aplicativo não o chama para criar um pagamento ou recuperar seu status.
Habilitar eventos de transação
Em Merchant Channel Events (Production), selecione os seguintes eventos na caixa http linha. Mantenha os identificadores de eventos exatamente como mostrados.
| Estágio de pagamento | Eventos para ativar |
|---|---|
| Autorização e erros | AUTHORIZED, REFUSED, ERROR |
| Captura | CAPTURED, CAPTURE_FAILED |
| Reembolso | SENT_FOR_REFUND, REFUNDED, REFUNDED_BY_MERCHANT, REFUND_REVERSED, REFUND_FAILED |
| Cancelamento e reversão | SHOPPER_CANCELLED, CANCELLED, REVERSED, VOIDED, CANCEL_FAILED |
3. Teste o fluxo de pagamento completo#
Use credenciais de sandbox e o fluxo de pagamento suportado pela sua conexão. Um teste de conexão bem-sucedido deve mostrar a operação de pagamento solicitada e o estado resultante.
As solicitações de captura, reembolso e anulação podem permanecer pendentes enquanto a Worldpay as processa. Uma solicitação aceita, o retorno do navegador ou um timeout não confirmam o resultado final. Use o estado mais recente do pedido e os webhooks da DEUNA configurados para reconciliar o pagamento original antes de tentar novamente ou concluir a operação.
Veja Fluxo de Pagamento & Statuses para o ciclo de vida do pagamento e DEUNA para notificações de back-end.
Se o resultado esperado não chegar
- Se a conexão não puder ser salva, verifique a conta selecionada, o ambiente, a operação e as credenciais XML com Worldpay.
- Se um pagamento permanecer pendente, verifique o endereço de notificação Worldpay,
POSTmétodo e selecionadohttpeventos antes de tentar novamente a operação original. - Se DEUNA tiver o resultado, mas seu back-end não, verifique seu Configuração de entrega do webhook DEUNA.
Ao escalar para DEUNA, inclua o ambiente, a referência do pedido, a tentativa de operação e o status observado. Não inclua credenciais ou dados completos do cartão.
Mude para a produção
Repita a configuração de conexão e notificação com credenciais de produção e o endereço de notificação de produção. Confirme as operações habilitadas e quaisquer requisitos de certificação com DEUNA e Worldpay e, em seguida, verifique o fluxo de pagamento da produção antes de aceitar o tráfego do cliente.
Operações suportadas#
Use esta referência para escolher o fluxo de pagamento a ser configurado e testado. Confirme cada recurso em relação ao catálogo de recursos Worldpay e a configuração da sua conta.
| Recurso | O que isso faz |
|---|---|
| Autorização | Reserva o valor solicitado na conta do titular sem capturar os fundos. É necessária uma captura separada para cobrar o pagamento. |
| Captura | Cobra os fundos de um pagamento previamente autorizado. Uma captura total cobra o valor autorizado disponível. |
| Compra | Autoriza e solicita a captura em um único fluxo de pagamento, sem uma solicitação de captura separada do lojista. |
| Captura parcial | Captura parte do valor previamente autorizado. Múltiplas capturas exigem ativação específica. |
| Múltiplas capturas parciais | Permite várias capturas de uma única autorização, sem exceder o saldo autorizado disponível. O modo de operação e a validade da autorização determinam como e quando as capturas podem ser solicitadas. |
| Anulação | Cancela uma autorização não capturada e solicita a liberação do valor ainda reservado. Não devolve fundos já capturados. |
| Reembolsos | Devolve fundos capturados ao titular do cartão. Um reembolso total devolve o saldo reembolsável restante. |
| Reembolsos parciais | Devolve parte do valor capturado ao titular do cartão. |
| Múltiplos reembolsos parciais | Permite vários reembolsos do mesmo pagamento capturado quando ativado. O total reembolsado não pode exceder o valor capturado confirmado. |
| Parcelamento pelo emissor | Permite que titulares elegíveis parcelem uma compra conforme as condições aceitas pelo emissor, pelo adquirente e pela conexão do lojista. |
| Carteiras digitais | Aceita pagamentos com Apple Pay e Google Pay quando a carteira está disponível e ativada para a conexão Worldpay. |
| MPI de 3-D Secure | A DEUNA gerencia a autenticação 3-D Secure, incluindo verificações do navegador e um desafio do emissor quando necessário. A autenticação também pode terminar sem um desafio visível. |
| Dados da companhia aérea | Transmite informações da transação aérea aceitas pela conexão, incluindo dados de passageiros, bilhetes e itinerários. Envie os dados de companhia aérea exigidos pelo seu fluxo de pagamento. |
Múltiplas capturas e reembolsos
O suporte a capturas e reembolsos parciais não ativa automaticamente múltiplas operações. Confirme o modo de operação e os limites por pedido com seu Technical Account Manager (TAM) da DEUNA e com a Worldpay.
No modo online, cada captura é enviada à Worldpay separadamente e não usa um prazo de corte de captura da DEUNA. A validade da autorização e os limites de captura da Worldpay continuam valendo. O prazo de captura configurado na DEUNA se aplica a capturas acumuladas (offline), nas quais a DEUNA envia o valor acumulado quando a sequência é encerrada. Consulte Múltiplas capturas parciais para conhecer as regras de cada modo.
Os múltiplos reembolsos devem respeitar o saldo reembolsável confirmado. Se a conexão usar acúmulo gerenciado pela DEUNA, uma solicitação parcial registra a intenção até o envio do reembolso acumulado; isso não significa que o cliente recebeu os fundos. Consulte Múltiplos reembolsos parciais para conhecer o fluxo com acúmulo.
Gerencie a autenticação 3-D Secure
Quando a autenticação exige uma ação no navegador, a DEUNA retorna a experiência hospedada pela próxima ação do pagamento. Sua integração a apresenta usando o widget, iframe ou redirecionamento compatível. As verificações do navegador podem terminar sem desafio do emissor; o titular só vê um desafio quando necessário.
Uma autenticação bem-sucedida não garante um pagamento aprovado ou capturado. Confirme o status final após a DEUNA concluir a autorização ou o processamento restante. Siga o fluxo de compra 3DS para tratar a próxima ação e a recuperação.
Carteiras e parcelamentos
Complete o separado Apple Pay ou Google Pay configuração antes de oferecer uma carteira na finalização da compra. A disponibilidade da carteira depende do mercado e da conexão.
Para parcelamento do emissor, ofereça apenas os termos elegíveis para o cartão, adquirente e conexão. Veja Parcelas para configurar campanhas e enviar a opção selecionada pelo cliente.
Requisitos regionais e de companhias aéreas#
Pagamentos de companhias aéreas
Forneça os dados da companhia aérea exigidos pelo seu fluxo na solicitação de autorização ou captura. Por um airline_order, os dados obrigatórios da companhia aérea deverão estar presentes em pelo menos uma dessas solicitações. Confirme as informações esperadas do passageiro, da passagem e do itinerário para sua conexão antes do teste.
Limites de captura e reembolso
Capture antes que a autorização expire. Confirme a janela de captura permitida com Worldpay e DEUNA; um limite de lote DEUNA não estende a autorização do emissor. Os reembolsos não podem exceder o valor capturado confirmado. Siga o regras do modo de operação antes de enviar mais de uma operação parcial.
Transações locais na Argentina
Para transações adquiridas localmente por Worldpay na Argentina, inclua o código postal, província e país do comprador na solicitação de autorização:
billing_address.zipcodebilling_address.state_namebilling_address.country_code
Worldpay usa essas informações para retenção de impostos provinciais. Se estiver ausente, a retenção será baseada na localização do comerciante. Envie o código ISO da província ou o código COMARB em billing_address.state_name, não ambos.
Códigos de província da Argentina
| Código da província COMARB | Código da província ISO | Nome da província |
|---|---|---|
| 901 | AR-C | CABA |
| 909 | AR-P | Formosa |
| 919 | AR-D | São Luís |
| 908 | AR-E | Entre Rios |
| 911 | AR-L | La Pampa |
| 917 | AR-A | Salta |
| 906 | AR-H | Chaco |
| 907 | AR-U | Chubut |
| 910 | AR-Y | Jujuy |
| 920 | AR-Z | Santa Cruz |
| 903 | AR-K | Catamarca |
| 904 | AR-X | Córdoba |
| 912 | AR-F | La Rioja |
| 922 | AR-G | Santiago del Estero |
| 918 | AR-J | São João |
| 913 | AR-M | Mendoza |
| 914 | AR-N | Missões |
| 915 | AR-Q | Neuquén |
| 916 | AR-R | Rio Negro |
| 923 | AR-V | Terra do Fogo |
| 902 | AR-B | Buenos Aires |
| 921 | AR-S | Santa Fé |
| 924 | AR-T | Tucumán |
| 905 | AR-W | Corrientes |
Próximos passos#
- Estratégias de pagamento: configure quando a conta conectada for usada.
- fluxo de compra 3DS: lida com ações do navegador, resultados de autenticação e recuperação.
- Notificações de status de pagamento: mantenha seu back-end alinhado com DEUNA.