Cetelem

Para realizar o pagamento através da adquirente Aura-Cetelem no Pagamento Online, 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 Pagamento Online 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 Pagamento Online – 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 Pagamento Online 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:

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.
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[]
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