Pular para o conteúdo principal
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.

01
Prepare-se
Confirme o acesso à conta, credenciais e operações suportadas.
02
Conecte-se em DEUNA
Adicione Worldpay e escolha como os pagamentos serão processados.
03
Configurar notificações
Habilite os eventos Worldpay que mantêm DEUNA atualizado.
04
Verifique o fluxo
Teste os resultados do pagamento antes de usar credenciais de produção.

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.

DEUNA Admin · Prévia da configuração
ConexõesSandbox
DescobrirAtivas
Pesquisar conexões
Worldpay
Gateway de pagamentoWorldpay
Configuração ilustrativa. Nenhuma credencial é enviada.

Insira as configurações de conexão

  1. Escolha um nome de conexão reconhecível para que sua equipe possa distingui-lo de outras contas ou ambientes.
  2. Selecione a moeda quando solicitada e insira as credenciais Worldpay emitidas para essa conexão.
  3. 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.
  4. 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.
  5. Selecione Conectar e verifique se Worldpay aparece em Conexões Ativas.
Campo DEUNAValor a inserir
Merchant IDO ID do comerciante Worldpay emitido para a conexão.
Chave privadaA chave privada XML Worldpay.
Chave PúblicaA 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 AmbienteEndereço de notificação Worldpay
Caixa de areiahttps://api.sandbox.deuna.io/transactions/webhooks/payconnect/payment-processors/worldpay
Produçãohttps://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.

Worldpay MAI: use the http row to configure notification delivery. Labels in Worldpay's own interface may differ from your documentation language.

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 pagamentoEventos para ativar
Autorização e errosAUTHORIZED, REFUSED, ERROR
CapturaCAPTURED, CAPTURE_FAILED
ReembolsoSENT_FOR_REFUND, REFUNDED, REFUNDED_BY_MERCHANT, REFUND_REVERSED, REFUND_FAILED
Cancelamento e reversãoSHOPPER_CANCELLED, CANCELLED, REVERSED, VOIDED, CANCEL_FAILED
Worldpay MAI: enable the listed events in the http row, then save the configuration.

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, POST método e selecionado http eventos 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.

RecursoO que isso faz
AutorizaçãoReserva o valor solicitado na conta do titular sem capturar os fundos. É necessária uma captura separada para cobrar o pagamento.
CapturaCobra os fundos de um pagamento previamente autorizado. Uma captura total cobra o valor autorizado disponível.
CompraAutoriza e solicita a captura em um único fluxo de pagamento, sem uma solicitação de captura separada do lojista.
Captura parcialCaptura parte do valor previamente autorizado. Múltiplas capturas exigem ativação específica.
Múltiplas capturas parciaisPermite 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çãoCancela uma autorização não capturada e solicita a liberação do valor ainda reservado. Não devolve fundos já capturados.
ReembolsosDevolve fundos capturados ao titular do cartão. Um reembolso total devolve o saldo reembolsável restante.
Reembolsos parciaisDevolve parte do valor capturado ao titular do cartão.
Múltiplos reembolsos parciaisPermite vários reembolsos do mesmo pagamento capturado quando ativado. O total reembolsado não pode exceder o valor capturado confirmado.
Parcelamento pelo emissorPermite que titulares elegíveis parcelem uma compra conforme as condições aceitas pelo emissor, pelo adquirente e pela conexão do lojista.
Carteiras digitaisAceita pagamentos com Apple Pay e Google Pay quando a carteira está disponível e ativada para a conexão Worldpay.
MPI de 3-D SecureA 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éreaTransmite 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.zipcode
  • billing_address.state_name
  • billing_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 COMARBCódigo da província ISONome da província
901AR-CCABA
909AR-PFormosa
919AR-DSão Luís
908AR-EEntre Rios
911AR-LLa Pampa
917AR-ASalta
906AR-HChaco
907AR-UChubut
910AR-YJujuy
920AR-ZSanta Cruz
903AR-KCatamarca
904AR-XCórdoba
912AR-FLa Rioja
922AR-GSantiago del Estero
918AR-JSão João
913AR-MMendoza
914AR-NMissões
915AR-QNeuquén
916AR-RRio Negro
923AR-VTerra do Fogo
902AR-BBuenos Aires
921AR-SSanta Fé
924AR-TTucumán
905AR-WCorrientes

Próximos passos#