Orbitall

Introdução#

A adquirente Orbitall é responsável por processar cartões da própria rede varejista.

Para realizar o pagamento através da adquirente Orbitall no Carat, além dos parâmetros básicos do Serviço de Criação de Pagamento REST e do Serviço de Efetivação de Pagamento REST, são necessários alguns dados que serão enviados através do parâmetro prefixes descrito na seção de Prefixos abaixo.

Interfaces Carat suportadas para integração#

É possível utilizar as seguintes interfaces para a integração com o roteamento Orbitall:

  • Pagamento REST
  • Cancelamento REST
  • Cancelamento via Portal

Pagamento REST#

Criação de Pagamento REST#

A seguir, são listados os parâmetros com dados específicos para a transação via Orbitall que o aplicativo da loja virtual deve enviar no Serviço de criação de transação REST:

ParâmetroDescriçãoFormatoObrigatório
authorizer_idCódigo da Autorizadora no Carat – Usar o código Orbitall que é o 160≤ 10 ASim
installment_typeTipo do financiamento de parcelamento.

Valores permitidos:
3 - parcelado com juros
4 - parcelado sem juros ou
37 - Crédito CDC.
= 2 NNão

Efetivação de Pagamento REST#

A seguir, são listados os parâmetros com dados específicos para a transação via Orbitall que o aplicativo da loja virtual deve enviar no Serviço de efetivação de transação REST:

ParâmetroDescriçãoFormatoObrigatório
acquirer.prefixesElemento para envio de prefixos do SiTef. Caso o prefixo enviado não seja suportado pelo cartão enviado, o Carat invalidará a transação, impedindo que se dê uma falsa impressão do uso de uma determinada funcionalidade.

Os prefixos suportados pela Orbitall estão listados na seção Prefixos.

Exemplo:
{ "key" : "value" } -> { "CICLOS" : "01" }
≤ 2000 ASim

Prefixos#

PrefixoDescriçãoTamanhoObrigatório
CICLOS:Deve ser enviado 0 (zero) quando o vencimento for na data do cartão ou de 1 a 99 indicando o número de ciclos a pular.
Para usar ciclos é necessária uma configuração previa no SiTef.
≤ 2 NSim
CPLANO:Código do plano acordado entre autorizadora e o estabelecimento. Obrigatório quando o tipo de financiamento for Crédito CDC.= 5 ANNão
TPCDC:Tipo de compra crédito CDC:
1 – CDC Produto
2 – CDC Serviço.
= 1 NNão
VLRADD:Valor adicional cobrado para compra tranquila, o parâmetro deve seguir o formato “cc=vv...vvv”, onde:
cc = 01 indicando compra tranquila.
vv...vvv indica o valor adicional para a compra tranquila (*) . Pode ser no máximo de tamanho 12 e é o valor SEM a vírgula.
≤ 15 ANNão

(*) é um seguro oferecido na compra CDC (ex: seguro se ficar desempregado). O valor passado na transação é referente ao valor total (compra + valor seguro). O cancelamento tambem é efetuado com o valor total. Para mais detalhes, consultar a rede adquirente.

Código de Autorizadora#

O código para a autorizadora Orbitall no Carat é 160. Para saber os códigos das demais autorizadoras no Carat, consulte aqui.