Cartão bancário

Cybersource é um gateway de pagamento global da Visa que permite o processamento seguro de pagamentos sem cartão presente. A DEUNA integra-se ao Bancard via API REST, suportando fluxos comerciais padrão e processamento especializado da indústria de viagens com campos de dados específicos das companhias aéreas.

Operações Suportadas

• Autorização
• Captura (total e parcial)
• Compra (captura automática)
• Cancelar (anular)
• Reembolso (total e parcial)
• Parcelas (somente para MX)
• 3DS MPI
• Múltiplas capturas parciais e reembolsos podem ser habilitados através da configuração no Admin

Métodos de pagamento suportados

• Visto
• Mastercard
• Expresso Americano
• Jantares

Países e moedas ativos

• EUA (USD) e PY (PYG)

Integrar Cartão Bancário#

1. Procure Bancard em Conexões no Admin.
   1. Faça login na sua sessão de administração DEUNA.
   2. Clique Conexões.
   3. Procure por Fonte cibernética e clique Conectar.
2. No Connections, o painel de configuração do Bancard será aberto. Digite o seguinte:
   1. Nome: insira um nome para fazer referência a essa configuração de credencial.
   2. Moeda: a moeda usada
   3. Chave privada: Insira sua chave privada da API Bancard.
   4. Chave Pública: Insira sua chave pública.
   5. Merchant ID: Insira seu ID de comerciante do cartão bancário.
   6. Configuração do adquirente(somente para MX): O lojista pode escolher qual processador usar. Se nenhum for especificado, selecione o Padrão option.
   7. Operações: Escolha o tipo de operação que deseja realizar: Comprar ou Autorização
   8. Escolha se deseja ativar Captura Parcial Múltipla, Reembolso Parcial Múltiplo e/ou 3DS DEUNA da DEUNA.
   9. Clique Conectar. Depois de terminar, você receberá uma mensagem de confirmação. Agora você pode consultá-lo na aba Conexões Ativas.

Indústria de viagens

• A DEUNA apoia o processamento para a indústria aérea e de viagens com o Cyberosurce, permitindo o envio de dados específicos da companhia aérea que qualificam as transações para melhores taxas de intercâmbio e conformidade com os requisitos da rede de cartões. _Isso está disponível apenas no mercado dos EUA.
• Os campos da companhia aérea exigem fluxo Auth + Capture
  • Envio de campos de dados da companhia aérea (orderType": "AIRLINE_ORDER") só tem suporte na etapa Captura de um fluxo Autorização + Captura.
  • Esta é uma limitação da Cybersource, não uma limitação da DEUNA. A operação Compra (captura automática) não oferece suporte a campos de dados de companhias aéreas.
  • Para utilizar dados da companhia aérea: configure a conexão no Admin com Autorização como tipo de operação.

Campos Obrigatórios – Pedido de Companhia Aérea

Exemplo:

{
  "order": {
    "airlineInformation": {
      "bookingItems": [
        {
          "legs": [
            {
              "carrierCode": "AM",
              "destination": {
                "date": "26-03-26",
                "iataCode": "MEX",
                "time": "11:50"
              },
              "fareBasisCode": "Y",
              "flightNumber": "411",
              "origin": {
                "date": "26-03-26",
                "iataCode": "EWR",
                "time": "08:01"
              },
              "serviceClass": "V",
              "stopoverCode": "O"
            },
          ],
          "passenger": {
            "firstName": "***dido",
            "lastName": "***chez",
            "type": "ADT"
          },
          "pnr": "CSOIUN"
        }
      ]
    },
    "billingAddress": {
      "address1": "***************3626",
      "address2": "***** 100",
      "addressType": "other",
      "city": "Sacramento",
      "countryCode": "PE",
      "createdAt": "2024-01-24T17:04:18.341610378Z",
      "email": "******eira@deuna.com",
      "firstName": "Jean",
      "identityDocument": "*******5894",
      "lastName": "*mith",
      "phone": "********7761",
      "stateName": "LIM",
      "updatedAt": "2024-01-24T17:04:18.34161046Z",
      "zipcode": "95864"
    },
    "currency": "USD",
    "itemsTotalAmount": 200,
    },
    "orderId": "66cc4f9d-293c-41a7-af80-377360a26134",
    "subTotal": 200,
    "timezone": "America/Mexico_City",
    "totalAmount": 200,
    "webhookUrls": {
      "notifyOrder": "https://webhook.site/cadu"
    }
  },
  "orderType": "AIRLINE_ORDER"
}

Considerações especiais e limitantes#

Processamento assíncrono e atualizações de status

• Ao contrário dos processadores síncronos, o Cybersource não retorna um status final definitivo imediatamente após o envio de uma transação. As transações progredirão através de status intermediários até que o processamento final seja concluído.
• A Cybersource executa seu processamento à noite. Durante o dia, as transações permanecerão em Processing, Capturing ou Refunding status.
• Após todo o processo no lado do Bancard, a DEUNA atualiza a transação para o seu estado final. Os comerciantes devem confiar no endpoint de status de transação da DEUNA para obter o estado atual de uma transação.