Cetelem

Para realizar o pagamento através da adquirente Aura-Cetelem no e-SiTef, 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 sessão de Prefixos abaixo.

IMPORTANTE: Antes de começar, verifique se a autorizadora desejada está utilizando como tipo de pagamento a rede = 93 (Aura – Cetelem).

Interfaces e-SiTef suportadas para integração

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

  • Pagamento REST
  • Pré-Autorização REST
  • Cancelamento REST
  • Cancelamento via Portal

Pagamento REST

Criação de Pagamento

A seguir, são listados os parâmetros com dados específicos para a transação via Cetelem 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 e-SiTef – Usar o código Aura-Cetelem que é o 93≤ 10 ASim
installment_typeTipo do financiamento de parcelamento.

Valores permitidos:
3 - rotativo normal
4 - rotativo normal ou parcelado ou
17 - crediário		= 2 NSim para crediário

Efetivação de Pagamento

A seguir, são listados os parâmetros com dados específicos para a transação via Cetelem 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 e-SiTef invalidará a transação, impedindo que se dê uma falsa impressão do uso de uma determinada funcionalidade.

Os prefixos suportados pela Aura-Cetelem estão listados na seção Prefixos.

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

Prefixos

PrefixoDescriçãoTamanhoObrigatório
CMATCódigo do Material vendido= 4 NSim para crediário
CPLANOCódigo do Plano= 5 ANSim para crediário

Pré-Autorização REST

Criação de Pré-Autorização

Abaixo está a descrição dos parâmetros específicos de Cetelem para o serviço de criação de pré-autorização REST:

ParâmetroDescriçãoFormatoObrigatório
additional_data
pre_auth_lifecycleRepresenta o número de dias em que se considera válida a pré-autorização.< 2 NNÃO
entry_amountValor de entrada em centavos.< 12 NNÃO
additional_data
.extra_param
.prefixes[] 		Elemento para envio de prefixos do SiTef. Caso o prefixo enviado não seja suportado pelo cartão enviado, o e-SiTef invalidará a transação, impedindo que se dê uma falsa impressão do uso de uma determinada funcionalidade.

Os prefixos suportados pela Aura-Cetelem estão listados na seção Prefixos.
keyNome do prefixo.< 1024 ANNÃO
valueValor do prefixo.< 1024 ANNÃO

Exemplo:

{
   "merchant_usn":"14111112826",
   "order_id":"14111112826",
   "authorizer_id":"6",
   "amount":"2300",
   "transaction_type":"preauthorization",
   "additional_data":{
      "pre_auth_lifecycle":"7",
      "entry_amount":"1",
      "extra_param":{
         "prefixes":[
            {
               "key":"CPLANO",
               "value":"13219"
            },
            {
               "key":"CMAT",
               "value":"11"
            }
         ]
      }
   }
}

Efetivação de Pré-Autorização

As informações de parcelamento (campos installments e installment_type) devem ser enviadas nesta etapa. Na captura, os mesmos valores devem ser utilizados.

Abaixo está a descrição específica de alguns parâmetros do Cetelem para o serviço de efetivação de pré-autorização REST:

ParâmetroDescriçãoFormatoObrigatório
installment_typeTipo do financiamento de parcelamento.

Valores permitidos:
3 - super limite crediário
4 - rotativo normal ou parcelado		= 2 NSIM
installmentsNúmero de parcelas da transação. Obs: utilize installment_type = 4 e installments = 1 para pagamentos à vista.= 2 NSIM

Captura de Pré-Autorização

Abaixo está a descrição específica de alguns parâmetros do Cetelem para o serviço de captura de pré-autorização REST:

ParâmetroDescriçãoFormatoObrigatório
installment_typeTipo do financiamento de parcelamento.

Valores permitidos:
3 - super limite crediário
4 - rotativo normal ou parcelado		= 2 NSIM
installmentsNúmero de parcelas da transação. Obs: utilize installment_type = 4 e installments = 1 para pagamentos à vista.= 2 NSIM

IMPORTANTE: Para o roteamento Cetelem, a captura de Pré-Autorização não necessita de dados de cartão.

Exemplo

Requisição:

curl
--request POST "https://esitef-homologacao.softwareexpress.com.br/e-sitef/api/v1/preauthorizations/capture/1234567890abcdefghijklmnopqrstuvwxyz1234567890abcdefghijklmnopqr"
--header "Content-Type: application/json"
--header "merchant_id: xxxxxxxx"
--header "merchant_key: xxxxxxxxxxx"
--data-binary
{
   "amount":"100",
   "installments":"1",
   "installment_type":"4",
   "acquirer":{
      "entry_amount": "1555"
   }
}
--verbose

Resposta:

{
   "code":"0",
   "message":"OK. Transaction successful.",
   "capture":{
      "status":"CON",
      "nit":"1234567890abcdefghijklmnopqrstuvwxyz1234567890abcdefghijklmnopqr",
      "order_id":"orderID",
      "customer_receipt":"=== CUSTOMER RECEIPT ===",
      "merchant_receipt":"=== MERCHANT RECEIPT ===",
      "authorizer_id":"2",
      "acquirer_id":"1005",
      "acquirer_name":"Redecard",
      "authorizer_code":"000",
      "authorizer_message":"Transacao OK.",
      "authorizer_date":"09/11/2018T19:40",
      "authorizer_merchant_id":"000000000000000",
      "authorization_number":"212195",
      "esitef_usn":"180921015287704",
      "merchant_usn":"20190101",
      "sitef_usn":"212195",
      "host_usn":"999212195",
      "amount":"100",
      "payment_type":"C",
      "issuer":"2"
   }
}

Abaixo está a descrição dos parâmetros específicos de Cetelem para o serviço de captura de pré-autorização REST:

ParâmetroDescriçãoFormatoObrigatório
acquirer
entry_amountValor de entrada em centavos.< 12 NNÃO
← BradescardGetnetLac →