Cartão Agência e Tipo de Processamento de Pagamento On-line

Visão geral 

O Cangooroo oferece duas funcionalidades complementares para pagamentos com cartão da agência: 

1. Cartão Agência para Pagamento Online e Fornecedores – permite cadastrar o cartão corporativo da agência ou um fornecedor gerador de cartão virtual (VCN) nas condições de pagamento. 

2. Tipo de processamento pagamento on-line – permite definir em que momento o cartão será efetivamente cobrado, quando o pagamento é processado no gateway da agência. 

A primeira define qual cartão será usado e para quê. A segunda define quando a cobrança acontece. 

Cartão Agência para Pagamento Online e Fornecedores 

Com essa configuração habilitada, a tela de Condições de pagamento da agência passa a exibir uma nova seção para cadastro de cartões. A habilitação deve ser solicitada ao nosso time de suporte. 

Como cadastrar 

Figura 1 – Seção Cartão Agência nas condições de pagamento, com o botão Novo 

1. Acesse a seção Cartão Agência para Pagamento Online e Fornecedores e clique em Novo. 2. Preencha os campos do cartão (tabela abaixo). 

3. Marque ao menos um Tipo de utilização do cartão. 

4. Clique em Salvar. O cartão passa a aparecer na listagem, com sua descrição e indicação de VCC.

Campos do cadastro 

Figura 2 – Formulário de cadastro do cartão 

CVV cartão Não Código de segurança do cartão. Nome do titular Não Nome impresso no cartão. 

Mês / Ano de Validade Não Validade do cartão.

Tipo de utilização do cartão 

• Pagamento online: o cartão é processado no gateway de pagamentos do cliente, dentro do Cangooroo. Nesse caso, é possível definir o momento da cobrança com a configuração Tipo de processamento pagamento on-line (próxima seção). 

• Enviar cartão para o fornecedor: o cartão é repassado ao fornecedor final, para tarifas em que o pagamento é feito diretamente no fornecedor. 

Uso do cartão via API 

Para processar o cartão cadastrado via API, informe o parâmetro CardId com o ID do cartão em cada quarto da reserva (Rooms[].CardId). Nesse caso, não envie o bloco Payment na requisição. 

"Rooms": [ 

{ 

"CardId": "XXX" 

} 

] 

Tipo de processamento pagamento on-line 

Objetivo 

Oferecer às agências maior controle sobre o momento em que o pagamento com cartão de crédito será efetivado, de acordo com a estratégia comercial e os acordos com fornecedores e clientes. 

Como funciona 

No painel administrativo da agência há a configuração Tipo de processamento pagamento on-line. Ela se aplica aos cartões com utilização Pagamento online, processados no gateway interno do cliente. As opções disponíveis são:

Figura 3 – Opções do Tipo de processamento pagamento on-line no painel administrativo 

API ReleaseCardPayment (opção Personalizado) 

No cenário Personalizado, a cobrança é liberada pelo método ReleaseCardPayment: 

POST 

https://ws-[ClientIdentification].cangooroo.net/API/REST/Hotel.svc/ReleaseCardPayment 

Requisição 

{ 

"Credential": { 

"Username": "{{USR}}", 

"Password": "{{PWD}}" 

}, 

"ServiceId": 1234, 

"Approver": "", 

"Requester": "" 

}

Resposta 

Erro: funcionalidade indisponível 

Se a opção Personalizado não estiver habilitada para a agência/cliente, a chamada não é processada e a API retorna: 

{ 

"Error": { 

"Message": "Unavailable functionality, check configurations." 

} 

} 

Considerações importantes 

• Agências com cartão fixo VCN nas condições de pagamento (ex.: VCN – B2B Pay, Jeeves): o cartão virtual é gerado no momento do booking, mas o pagamento é processado conforme a configuração definida. 

• Agências com cartão de crédito fixo nas condições de pagamento: o pagamento usa o número vinculado ao cardId no momento da execução. 

• Personalizado sem chamada ao ReleaseCardPayment: se o método não for executado, o pagamento é processado na data de check-in da reserva. 

• Registro de Approver e Requester: os valores informados nesses campos da requisição são registrados nas observações da reserva.