Cetelem

Para realizar el pago a través del adquirente Aura-Cetelem en Portal Carat, además de los parámetros básicos de Servicio de Creación de Pagos REST y Servicio de Eficiencia de Pago REST, se necesitan algunos datos que se enviarán a través del parámetro prefixes descrito en la sección Prefijos abajo.

IMPORTANTE: Antes de comenzar, verifique si la autorización deseada está utilizando la red como método de pago = 93 (Aura – Cetelem).

Interfaces Portal Carat apoyado para la integración#

Puede utilizar las siguientes interfaces para la integración con el enrutamiento Cetelem:

Pago REST
Preautorización REST
Cancelación REST
Cancelación a través del Portal

Pago REST#

Creación de pago#

Los parámetros con datos específicos para la transacción vía Cetelem que la aplicación de la tienda virtual debe enviar en el Servicio de creación de transacciones REST:

Parámetro	Descripción	Formato	Requerido
`authorizer_id`	Código del autorizador de pagos Online – Utilice el código Aura-Cetelem que es el `93`	≤ 10 A	Sí
`installment_type`	Tipo de financiación a plazos. Valores permitidos: `3` - rotativo normal `4` - rotativo normal ou parcelado ou `17` - crediário	= 2 N	Si al credito

Efectividad de pago#

Los parámetros con datos específicos para la transacción vía Cetelem que la aplicación de la tienda virtual debe enviar en el servicio de cumplimiento de transacciones REST:

Parámetro	Descripción	Formato	Requerido
`acquirer`
`prefixes`	Elemento para enviar prefijos SiTef. Si el prefijo enviado no es compatible con la tarjeta enviada, el Portal Carat invalidará la transacción, evitando que se dé una falsa impresión del uso de una determinada funcionalidad. Los prefijos admitidos por Aura-Cetelem se enumeran en la sección Prefijos. Ejemplo: `{ "key" : "value" }` -> `{ "CICLOS" : "01" }`	≤ 2000 A	Sí

Prefijos#

Prefijo	Descripción	Tamaño	Requerido
`CMAT`	Código de material vendido	= 4 N	sí para el pago a plazos
`CPLANO`	Código del plan	= 5 AN	Sí al crédito

Preautorización REST#

Creación de Preautorización#

A continuación se muestra una descripción de los parámetros específicos de Cetelem para el servicio de creación de preautorización REST:

Elemento para enviar prefijos SiTef. Si el prefijo enviado no es compatible con la tarjeta enviada, Portal Carat invalidará la transacción, evitando que se dé una falsa impresión del uso de una determinada funcionalidad.

Los prefijos admitidos por Aura-Cetelem se enumeran en la sección Prefijos.

Parámetro	Descripción	Formato	Obligatorio
`additional_data`
`pre_auth_lifecycle`	Representa el número de días que la preautorización se considera válida.	< 2 N	NO
`entry_amount`	Valor de entrada en centavos.	< 12 N	NO
`additional_data` `.extra_param` `.prefixes[]`
`key`	Nombre de prefijo.	< 1024 AN	NO
`value`	Valor de prefijo.	< 1024 AN	NO

Ejemplo:

{
  "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"
        }
      ]
    }
  }
}

Efectividad de la autorización previa#

Información sobre el pago a plazos (campos installments y installment_type) debe enviarse en esta etapa. En la captura, se deben utilizar los mismos valores.

A continuación se muestra la descripción específica de algunos parámetros de Cetelem para el servicio de ejecución de preautorización REST:

Parámetro	Descripción	Formato	Obligatorio
`installment_type`	Tipo de financiación a plazos. Valores permitidos: `3` - super limite crediário `4` - rotativo normal ou parcelado	= 2 N	SI
`installments`	Número de cuotas de la transacción. Nota: use installment_type = `4` y installments = `1` para pagos en efectivo.	= 2 N	SI

Captura de autorización previa#

A continuación se muestra la descripción específica de algunos parámetros de Cetelem para el servicio de captura de preautorización REST:

Parámetro	Descripción	Formato	Obligatorio
`installment_type`	Tipo de financiación a plazos. Valores permitidos: `3` - super limite crediário `4` - rotativo normal ou parcelado	= 2 N	SI
`installments`	Número de cuotas de la transacción. Nota: use installment_type = `4` y installments = `1` para pagos en efectivo.	= 2 N	SI

IMPORTANTE: Para el enrutamiento de Cetelem, la captura de autorización previa no requiere datos de tarjeta.

Ejemplo#

Solicitud:

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

Respuesta:

{
  "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"
  }
}

A continuación se muestra la descripción de los parámetros específicos de Cetelem para el servicio de captura de autorización previa REST:

Parámetro	Descripción	Formato	Obligatorio
`acquirer`
`entry_amount`	Valor de entrada en centavos.	< 12 N	NO

Home