Companhias Aéreas e Agências de Viagem - Colômbia

Considerações:

• Disponível exclusivamente na Colômbia para transações em moeda COP.
• Permite o processamento de pagamentos por meio do modelo TSP/Gateway.
• Requer o registro de códigos IATA junto aos adquirentes.
• Suporta pagamentos com cartões de crédito ou débito, incluindo Amex, Diners, Mastercard e Visa.
• Permite dispersão de fundos, possibilitando que agências de viagem e companhias aéreas recebam seus pagamentos na mesma transação.
• Requer processamento em uma única etapa: o sistema transfere os fundos da conta do cliente para o banco adquirente assim que o pagamento é autorizado.

Funcionalidades da Integração:

Essa integração simplifica o processo de pagamento para companhias aéreas e agências de viagem na Colômbia, permitindo que elas enviem informações essenciais com cada transação para identificação precisa e distribuição de fundos. Além disso, o envio de detalhes específicos da transação pode qualificá-lo para isenção do imposto de 4 x 1000 (confirme com o banco adquirente).

Etapas de Integração

1. Obtenha a lista de companhias aéreas disponíveis.
2. Crie o formulário WebCheckout, incluindo o código da companhia aérea e tarifas e impostos aeroportuários.

1) Obtenha a Lista de Companhias Aéreas Disponíveis

Para integrar-se à PayU, companhias aéreas e agências de viagem precisam obter a lista de códigos válidos de companhias aéreas para cobrança e incluí-los no WebCheckout. Isso pode ser feito consultando o sistema da PayU para obter uma lista das companhias aéreas disponíveis e seus códigos correspondentes. O endpoint para recuperação dos códigos é o mesmo para ambos os tipos de comerciantes, embora o uso possa variar:

• Companhias Aéreas:

  • Obtêm e enviam seus próprios códigos para habilitar identificação precisa e possíveis benefícios fiscais.
  • Fornecendo o código, garantem transações otimizadas para suas taxas e encargos associados.

• Agências de Viagem:

  • Obtêm o código da companhia aérea associado a cada pagamento para garantir a alocação correta de taxas e impostos.
  • Essa integração ajuda a identificar a companhia aérea envolvida na transação para distribuição adequada dos fundos.

Etapas para Obter a Lista

1. Utilize os seguintes endpoints conforme o ambiente:

• Sandbox: https://sandbox.api.payulatam.com/payments-api/rest/v4.3/payments/airline
• Produção: https://api.payulatam.com/payments-api/rest/v4.3/payments/airline

2. Inclua o seguinte parâmetro de consulta na solicitação:

3. Inclua o seguinte cabeçalho para autenticação:

Exemplo de código em JavaScript para gerar o cabeçalho de autenticação:

var contentToSign = "pRRXKOl8ikMmt9u" + ":" + "4Vj8eK4rloUd272L48hsrarnUA";
var base64 = CryptoJS.enc.Base64.stringify(CryptoJS.enc.Utf8.parse(contentToSign));
var authenticationHeader = "Basic " + base64.toString();

Exemplo de uma Resposta:

A resposta será um payload JSON ou XML contendo um array de companhias aéreas com seus respectivos códigos e descrições.

{
  "airlines": [
    {
      "code": "81",
      "description": "AVIA MARKETING LTDA NAL Nacional"
    },
    .
    .
    .
    {
      "code": "65",
      "description": "OCEANAIR LINHAS AEREAS S.A Nacional"
    }
  ]
}

<com.pagosonline.ppp4.web.payments.api.v4.model.ApiAirlinesListResponse>
 <airlines>
 <com.pagosonline.ppp4.web.payments.api.v4.model.ApiAirlines>
 <code>80</code>
 <description>AVIATUR S.A. BOG Internacional</description>
 </com.pagosonline.ppp4.web.payments.api.v4.model.ApiAirlines>
 .
 .
 .
 <com.pagosonline.ppp4.web.payments.api.v4.model.ApiAirlines>
 <code>87</code>
 <description>LAN AIRLINES Nacional</description>
 </com.pagosonline.ppp4.web.payments.api.v4.model.ApiAirlines>
 </airlines>
</com.pagosonline.ppp4.web.payments.api.v4.model.ApiAirlinesListResponse>

2) Crie o Formulário WebCheckout

Esta etapa envolve redirecionar seus clientes para a página de pagamento segura da PayU, onde eles podem escolher o método de pagamento preferido e concluir a compra. Para isso, basta adicionar o código da companhia aérea obtido na etapa anterior, juntamente com taxas aeroportuárias e impostos, como campos ocultos no formulário de pagamento.

Formulário de Pagamento para Companhias Aéreas

Inclua os parâmetros específicos para companhias aéreas, além dos parâmetros padrão para o formulário de pagamento.

Exemplo de Formulário WebCheckout

Abaixo, um exemplo do formulário WebCheckout:

<form method="post" action="https://sandbox.checkout.payulatam.com/ppp-web-gateway-payu/">
 <input name="merchantId" type="hidden" value="508029">
 <input name="accountId" type="hidden" value="513128">
 <input name="description" type="hidden" value="Flight 12345">
 <input name="referenceCode" type="hidden" value="PNR-123">
 <input name="airline" type="hidden" value="29" >
 <input name="amount" type="hidden" value="119000">
 <input name="tax" type="hidden" value="19000">
 <input name="taxReturnBase" type="hidden" value="100000">
 <input name="additionalValue" type="hidden" value="25000">
 <input name="currency" type="hidden" value="COP" >
 <input name="algorithmSignature" type="hidden" value="SHA256">
 <input name="signature" type="hidden" value="b94d73892255c4f53af4282e3a5b6551526a922f1fcf1412fafa6bdf8bbe32f0">
 <input name="buyerEmail" type="hidden" value="pruebas@payulatam.com">
 <input name="responseUrl" type="hidden" value="http://www.mysite.com/response-page">
 <input name="confirmationUrl" type="hidden" value="http://www.mysite.com/confirmation-page">
 <input name="test" type="hidden" value="0">
 <input name="Submit" type="submit" value="Send">
</form>

Formulário de Pagamento para Agências de Viagens

Inclua os parâmetros específicos para agências de viagens, além dos parâmetros padrão para o formulário de pagamento.

Exemplo de Formulário WebCheckout

Abaixo, um exemplo do formulário WebCheckout:

<form method="post" action="https://sandbox.checkout.payulatam.com/ppp-web-gateway-payu/">
 <input name="merchantId" type="hidden" value="508029">
 <input name="accountId" type="hidden" value="513128">
 <input name="description" type="hidden" value="Flight 12345">
 <input name="referenceCode" type="hidden" value="PNR-123">
 <input name="airline" type="hidden" value="29" >
 <input name="amount" type="hidden" value="119000">
 <input name="tax" type="hidden" value="19000">
 <input name="taxReturnBase" type="hidden" value="100000">
 <input name="additionalValue" type="hidden" value="25000">
 <input name="administrativeFee" type="hidden" value="5950">
 <input name="taxAdministrativeFee" type="hidden" value="950">
 <input name="taxAdministrativeFeeReturnBase" type="hidden" value="5000">
 <input name="currency" type="hidden" value="COP" >
 <input name="algorithmSignature" type="hidden" value="SHA256">
 <input name="signature" type="hidden" value="b94d73892255c4f53af4282e3a5b6551526a922f1fcf1412fafa6bdf8bbe32f0">
 <input name="buyerEmail" type="hidden" value="pruebas@payulatam.com">
 <input name="responseUrl" type="hidden" value="http://www.mysite.com/response-page">
 <input name="confirmationUrl" type="hidden" value="http://www.mysite.com/confirmation-page">
 <input name="test" type="hidden" value="0">
 <input name="Submit" type="submit" value="Send">
</form>