Cetelem

Para realizar o pagamento através da adquirente Aura-Cetelem 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 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 Carat 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âmetro	Descrição	Formato	Obrigatório
`authorizer_id`	Código da Autorizadora no Carat – Usar o código Aura-Cetelem que é o `93`	≤ 10 A	Sim
`installment_type`	Tipo do financiamento de parcelamento. <br/><br/> Valores permitidos: <br/>`3` - rotativo normal <br/>`4` - rotativo normal ou parcelado ou <br/>`17` - crediário	= 2 N	Sim 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âmetro	Descrição	Formato	Obrigatório
`acquirer`	<td colspan="3" />
`prefixes`	Elemento 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. <br/><br/> Os prefixos suportados pela Aura-Cetelem estão listados na seção Prefixos. <br/><br/> Exemplo: <br/> `{ "key" : "value" }` -> `{ "CICLOS" : "01" }`	≤ 2000 A	Sim

Prefixos

Prefixo	Descrição	Tamanho	Obrigatório
`CMAT`	Código do Material vendido	= 4 N	Sim para crediário
`CPLANO`	Código do Plano	= 5 AN	Sim 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âmetro	Descrição	Formato	Obrigatório
`additional_data`	<td colspan="3" />
`pre_auth_lifecycle`	Representa o número de dias em que se considera válida a pré-autorização.	< 2 N	NÃO
`entry_amount`	Valor de entrada em centavos.	< 12 N	NÃO
`additional_data`<br/>`.extra_param`<br/>`.prefixes[]`	<td colspan="3" /> Elemento 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. <br/><br/> Os prefixos suportados pela Aura-Cetelem estão listados na seção Prefixos.
`key`	Nome do prefixo.	< 1024 AN	NÃO
`value`	Valor do prefixo.	< 1024 AN	NÃ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âmetro	Descrição	Formato	Obrigatório
`installment_type`	Tipo do financiamento de parcelamento. <br/><br/> Valores permitidos: <br/>`3` - super limite crediário <br/>`4` - rotativo normal ou parcelado	= 2 N	SIM
`installments`	Número de parcelas da transação. Obs: utilize installment_type = `4` e installments = `1` para pagamentos à vista.	= 2 N	SIM

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âmetro	Descrição	Formato	Obrigatório
`installment_type`	Tipo do financiamento de parcelamento. <br/><br/> Valores permitidos: <br/>`3` - super limite crediário <br/>`4` - rotativo normal ou parcelado	= 2 N	SIM
`installments`	Número de parcelas da transação. Obs: utilize installment_type = `4` e installments = `1` para pagamentos à vista.	= 2 N	SIM

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://{{url}}/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âmetro	Descrição	Formato	Obrigatório
`acquirer`	<td colspan="3" />
`entry_amount`	Valor de entrada em centavos.	< 12 N	NÃO