Fepas HUB

La tienda tiene la capacidad de configurar el enrutamiento de las transacciones realizadas en Pago Online mediante varios métodos de pago, uno de los cuales es el FEPAS HUB.

El propósito de esta documentación es describir los campos disponibles en Pago Online para permitir las ventas en el FEPAS HUB.

ATENCIÓN : este enrutamiento es solo para transacciones contactless de transporte.

Interfaces Pago Online apoyado para la integración#

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

Pago REST
Cancelación de REST
Preautorización REST
REST iniciar sesión
Carga de tablas de descanso

ATENCIÓN : La función de programación no es compatible con esta ruta.

Pago REST#

Los siguientes campos son complementarios a los mencionados en la documentación del Servicio de pago.

Efectividad de pago REST#

Solicitud de pago#

Parámetro	Descripción	Formato	Requerido
`resubmission_id`	ID utilizado para volver a enviar un pago previamente denegado en ciertos casos según lo permita el emisor.	= 16 N	Cond.
`acquirer_id`	Código de ruta que se utilizará en la transacción. Puede asumir los valores de los códigos descritos en la tabla Códigos de ruta. Si no se envía este campo, se utilizará la configuración de autorización de la tienda para definir el enrutamiento.	< 4 N	NO
`original_authorization_number`	Número de autorización de la transacción original.	< 6 AN	Cond.
`authorizer_mac`	MAC de la transacción de compra de (todas las banderas) Código de asesoramiento comercial (MAC) ASCII de 4 posiciones.	< 4 AN	Cond.
`authorization_terminal`	Atributo de tipo authorization_terminal

`authentication`	atributo de tipo authentication
`terminal`	atributo de tipo terminal
`card`	Atributo de tipo card
`mtt`	Atributo de tipo mtt

Ejemplo de solicitud de pago#

curl
--request POST "https://esitef-homologacao.softwareexpress.com.br/e-sitef-hml/api/v1/payments/1234567890abcdefghijklmnopqrstuvwxyz1234567890abcdefghijklmnopqr"
--header "Content-Type: application/json"
--header "merchant_id: xxxxxxxx"
--header "merchant_key: xxxxxxxxxxx"
--data-binary
{
    "card":{
        "expiry_date":"1222",
        "crypto":{
            "ksn":"xxxxxxxxxxx"
        },
        "track_2":"****************************************",
        "pos_entry_mode":{
            "value":"07",
            "pin_capability":"2"
        },
        "emv":{
            "card_sequence_number":"xxxxxx",
            "data":"820258009F2701809F2608B42433F98916B3319F36020074"
        }
    },
    "terminal":{
        "id":"SE111111",
        "type":"2",
        "input_mode":"5",
        "pin_pad_physical_features":"6",
        "handling_type":"1",
        "reader_capabilities":"7"
    },
    "mtt": {
        "id": "1",
        "first_journey_date": "0925",
        "vehicle_id": "012345678901234567",
        "gps_location": "050.167958;-097.133000"
    },
    "resubmission_id": "0123456789012345"
}
--verbose

Respuesta de pago#

Parámetro	Descripción	Formato
`resubmission_id`	ID para ser utilizado para reenviar en caso de pago denegado.	= 16 N
`payment`	Atributo de tipo payment
`card`	Atributo de tipo resp_card

Ejemplo de respuesta de pago#

{
    "code":"0",
    "message":"OK. Transaction successful.",
    "payment":{
        "authorizer_code":"000",
        "authorizer_message":"Transacao OK",
        "status":"CON",
        "nit":"1234567890abcdefghijklmnopqrstuvwxyz1234567890abcdefghijklmnopqr",
        "order_id":"13034649671",
        "customer_receipt":"====CUPOM COMPRADOR====",
        "merchant_receipt":"====CUPOM ESTABELECIMENTO====",
        "authorizer_id":"2",
        "acquirer_id":"0005",
        "acquirer_name":"FEPAS HUB",
        "authorizer_date":"07/08/2018T16:52",
        "authorization_number":"132030",
        "merchant_usn":"13034649671",
        "esitef_usn":"170713097340300",
        "sitef_usn":"132030",
        "host_usn":"999132030",
        "tid": "000030000016",
        "payment_date":"07/08/2018T16:52",
        "amount":"1000",
        "payment_type":"C",
        "issuer":"2",
        "authorizer_merchant_id":"000000000000005",
        "acquirer_table_load_required":"0",
        "conciliation_authorizer_merchant_id":"6887542",
        "authorization_terminal":{
            "usn":"555845",
            "id":"SE111111"
        }
    },
    "resubmission_id": "0123456789012345"
}

Confirmación de pago REST#

Los siguientes campos son complementarios a los mencionados en la documentación del Servicio de confirmación de pago.

Solicitud de confirmacion#

Parámetro	Descripción	Formato	Obligatorio
`issuer_scripts_results`	Issuer Scripts Results Presente si la transacción se realiza con un chip EMV.	= N/A AN	Cond.

Ejemplo de solicitud de confirmación#

curl
--request PUT "https://esitef-homologacao.softwareexpress.com.br/e-sitef-hml/api/v1/payments/1234567890abcdefghijklmnopqrstuvwxyz1234567890abcdefghijklmnopqr?confirm=true&issuer_scripts_results=xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
--header "merchant_id:xxxxxxxxxxxxxxx"
--header "merchant_key:xxxxxxxxxxx"
--verbose

Respuesta de confirmación#

No hay campos adicionales.

Ejemplo de respuesta de confirmación#

{
  "code": "0",
  "message": "OK. Transaction successful.",
  "payment": {
    "status": "CON"
  }
}

Cancelación de REST#

Efectividad de cancelación de REST#

Los siguientes campos son complementarios a los mencionados en la documentación del Servicio de cancelación.

Solicitud de cancelacion#

Parámetro	Descripción	Formato	Obligatorio
`terminal`	Atributo de tipo terminal
`card`	Atributo de tipo card
`authentication`	Atributo de tipo authentication

Ejemplo de solicitud de cancelación#

curl
--request PUT "https://esitef-homologacao.softwareexpress.com.br/e-sitef/api/v1/cancellations/1234567890abcdefghijklmnopqrstuvwxyz1234567890abcdefghijklmnopqr"
--header "Content-Type: application/json"
--header "merchant_id: xxxxxxxx"
--header "merchant_key: xxxxxxxxxxx"
--data-binary
{
    "card":{
        "crypto":{
            "ksn":"xxxxxxxxxxx"
        },
        "pos_entry_mode":{
            "value":"81",
            "pin_capability":"1"
        },
        "track_2":"****************************************",
        "expiry_date":"1222"
    },
    "terminal":{
        "id":"SE111111",
        "type":"0",
        "input_mode":"5",
        "pin_pad_physical_features":"3",
        "handling_type":"1",
        "reader_capabilities":"4",
        "chip_conditions":"2"
    },
    "authentication":{
        "pin":{
            "crypto":{
                "type":"002"
            }
        }
    },
    "amount":"1500"
}
--verbose

Respuesta de Cancelación#

Parámetro	Descripción	Formato	Obligatorio
`cancellation`	Atributo de tipo cancellation

Ejemplo de respuesta de cancelación#

{
  "code": "0",
  "message": "OK. Transaction successful.",
  "cancellation": {
    "authorizer_code": "00",
    "authorizer_message": "Sucesso",
    "status": "CON",
    "nit": "10f53cd3dab3222e5e37b725dfe368331958866a2d07c4ba7f382a8c5f42fd9e",
    "order_id": "03110843259",
    "customer_receipt": "=== RECIBO DE CANCELAMENTO ===",
    "authorizer_id": "2",
    "acquirer_id": "412",
    "acquirer_name": "FEPAS HUB",
    "authorizer_date": "03/09/2018T11:09",
    "authorization_number": "030020",
    "merchant_usn": "3110843259",
    "esitef_usn": "180903014387861",
    "sitef_usn": "000060",
    "host_usn": "999030021",
    "tid": "000030000014",
    "amount": "1500",
    "payment_type": "C",
    "authorizer_merchant_id": "000000000100250",
    "conciliation_authorizer_merchant_id": "000000000100250",
    "authorization_terminal": {
      "usn": "030021",
      "id": "F1000001"
    },
    "esitef_date": "03/09/2018T11:09",
    "is_host_cancel": "false"
  }
}

Preautorización REST#

Los siguientes campos son complementarios a los mencionados en la documentación de Servicio de ejecución de preautorización.

Efectividad de preautorización REST#

Solicitud de Preautorización#

Parámetro	Descripción	Formato	Obligatorio
`resubmission_id`	Identificación utilizada para volver a enviar un pago previamente denegado en ciertos casos según lo permita el emisor.	= 16 N	Cond.
`acquirer_id`	Código de ruta que se utilizará en la transacción. Puede asumir los valores de los códigos descritos en la tabla Códigos de Enrutamiento. Si este campo no se envía, la configuración de autorización de la tienda se utilizará para definir el enrutamiento.	< 4 N	NO
`authentication`	Atributo de tipo authentication
`terminal`	Atributo de tipo terminal
`card`	Atributo de tipo card
`mtt`	Atributo de tipo mtt

Ejemplo de solicitud de Preautorización#

curl
--request POST "https://esitef-homologacao.softwareexpress.com.br/e-sitef-hml/api/v1/preauthorizations/1234567890abcdefghijklmnopqrstuvwxyz1234567890abcdefghijklmnopqr"
--header "Content-Type: application/json"
--header "merchant_id: xxxxxxxx"
--header "merchant_key: xxxxxxxxxxx"
--data-binary
{
    "card":{
        "expiry_date":"1222",
        "crypto":{
            "ksn":"xxxxxxxxxxx"
        },
        "track_2":"****************************************",
        "pos_entry_mode":{
            "value":"07",
            "pin_capability":"2"
        },
        "emv":{
            "card_sequence_number":"xxxxxx",
            "data":"820258009F2701809F2608B42433F98916B3319F36020074"
        }
    },
    "terminal":{
        "id":"SE111111",
        "type":"2",
        "input_mode":"5",
        "pin_pad_physical_features":"6",
        "handling_type":"1",
        "reader_capabilities":"7"
    },
    "mtt": {
        "id": "1",
        "first_journey_date": "0925",
        "vehicle_id": "012345678901234567",
        "gps_location": "050.167958;-097.133000"
    },
    "resubmission_id": "0123456789012345"
}
--verbose

Responde desde Preautorización#

Parámetro	Descripción	Formato
`resubmission_id`	Identificación que se utilizará para volver a enviar en caso de que se niegue el pago.	= 16 N
`pre_authorization`	Atributo de tipo pre_authorization
`card`	Atributo de tipo resp_card

Ejemplo de respuesta de Preautorización#

{
    "code":"0",
    "message":"OK. Transaction successful.",
    "pre_authorization":{
        "authorizer_code":"000",
        "authorizer_message":"Transacao OK",
        "status":"CON",
        "nit":"1234567890abcdefghijklmnopqrstuvwxyz1234567890abcdefghijklmnopqr",
        "customer_receipt":"====CUPOM COMPRADOR====",
        "merchant_receipt":"====CUPOM ESTABELECIMENTO====",
        "authorizer_id":"2",
        "order_id":"13034649671",
        "acquirer_name":"FEPAS HUB",
        "acquirer_id":"0005",
        "authorization_number":"132030",
        "merchant_usn":"13034649671",
        "authorizer_date":"07/08/2018T16:52",
        "esitef_usn":"170713097340300",
        "sitef_usn":"132030",
        "host_usn":"999132030",
        "amount":"1000",
        "tid": "000030000016",
        "issuer":"2",
        "payment_type":"C",
        "authorizer_merchant_id":"000000000000005",
        "acquirer_table_load_required":"0",
        "conciliation_authorizer_merchant_id":"6887542",
        "authorization_terminal":{
            "usn":"555845",
            "id":"SE111111"
        }
    },
    "resubmission_id": "0123456789012345"
}

Captura de Preautorización REST#

Los siguientes campos son complementarios a los mencionados en la documentación de Servicio de captura de preautorización.

Ejemplo de solicitud de Captura de Preautorización#

curl
--request POST "https://esitef-homologacao.softwareexpress.com.br/e-sitef-hml/api/v1/preauthorizations/capture/1234567890abcdefghijklmnopqrstuvwxyz1234567890abcdefghijklmnopqr"
--header "merchant_id:xxxxxxxxxxxxxxx"
--header "merchant_key:xxxxxxxxxxx"
--data-binary
{
    "card":{
        "expiry_date":"1222",
        "crypto":{
            "ksn":"xxxxxxxxxxx"
        },
        "track_2":"****************************************",
        "pos_entry_mode":{
            "value":"07",
            "pin_capability":"2"
        },
        "emv":{
            "card_sequence_number":"xxxxxx",
            "data":"820258009F2701809F2608B42433F98916B3319F36020074"
        }
    },
    "terminal":{
        "id":"SE111111",
        "type":"2",
        "input_mode":"5",
        "pin_pad_physical_features":"6",
        "handling_type":"1",
        "reader_capabilities":"7"
    }
--verbose

Respuesta de Captura de Preautorización#

No hay campos adicionales.

Ejemplo de respuesta de Captura de Preautorización#

{
  "code": "0",
  "message": "OK. Transaction successful.",
  "capture": {
        "authorizer_code":"000",
        "authorizer_message":"Transacao OK",
        "status":"CON",
        "nit":"1234567890abcdefghijklmnopqrstuvwxyz1234567890abcdefghijklmnopqr",
        "customer_receipt":"====CUPOM COMPRADOR====",
        "merchant_receipt":"====CUPOM ESTABELECIMENTO====",
        "authorizer_id":"2",
        "order_id":"13034649671",
        "acquirer_name":"FEPAS HUB",
        "acquirer_id":"0005",
        "authorization_number":"132030",
        "merchant_usn":"13034649671",
        "authorizer_date":"07/08/2018T16:52",
        "esitef_usn":"170713097340300",
        "sitef_usn":"132030",
        "host_usn":"999132030",
        "amount":"1000",
        "issuer":"2",
        "payment_type":"C",
        "authorizer_merchant_id":"000000000000005"
  }
}

Logon REST#

El Logon es una función exclusiva del enrutamiento FEPAS.

Caso el campo version enviado en la solicitud es diferente del campo acquirer_table_load.version de la respuesta, será necesario realizar la Carga de Tablas.

Solicitud de Logon#

Parámetro	Descripción	Formato	Obligatorio
`authorizer_id`	Código de autorizador.	< 4 N	SI
`acquirer_id`	Código de ruta que se utilizará en la transacción. Puede asumir los valores de los códigos descritos en la tabla Códigos de ruta. Si no se envía este campo, se utilizará la configuración de autorización de la tienda para definir el enrutamiento.	< 4 N	NO
`version`	Versión de las tablas de parámetros presentes en la red de captura referidas a un Autorizador. Cada autorizador tendrá una versión diferente de parámetros. Nota: Si aún no hay mesas en el establecimiento, envíe ceros.	< 8 N	SI
`terminal`	Atributo de tipo terminal NOTA: Solo el atributo `id` contenido en el atributo de tipo `terminal` es necesario en Logon.

Ejemplo de solicitud de Logon#

curl
--request POST "https://esitef-homologacao.softwareexpress.com.br/e-sitef/api/v1/acquirer_tables"
--header "Content-Type: application/json"
--header "merchant_id: xxxxxxxx"
--header "merchant_key: xxxxxxxxxxx"
--data-binary
{
    "authorizer_id":"2",
    "version":"4",
    "terminal": {
        "id":"ES000001"
    }
}
--verbose

Respuesta de Logon#

Parámetro	Descripción	Formato
`code`	Código de respuesta de pago en línea. Cualquier código que no sea "0" significa error. Para obtener más información, consulte la sección [Códigos API].(codigos-da-api.md#códigos-de-resposta).	< 4 N
`message`	Mensagem de resposta do Pago Online.	< 500 AN
`acquirer_table`	Atributo de tipo acquirer_table

Ejemplo de respuesta de Logon#

{
  "code": "0",
  "message": "OK. Transaction successful.",
  "acquirer_table": {
    "code": "00",
    "message": "Sucesso",
    "acquirer_id": "5",
    "acquirer_name": "Redecard",
    "usn": "000230",
    "merchant_code": "000000000100250",
    "version": "40361885",
    "signature": "R8yxlnT24sSm1Zt77Jj44pohO8LapTNjWt1nqV8zGKg=",
    "date": "06/09/2018T11:32:31"
  }
}

Carga de tablas REST#

Carga de Tablas es una característica exclusiva del enrutamiento FEPAS. Esta solicitud solo se puede ejecutar después de Logon y reutiliza la información que devuelve, como los valores de campo: acquirer_table.usn, authorizer_id, version y terminal.id.

Solicitud de Carga de Tablas#

Parámetro	Descripción	Formato	Obligatorio
`authorizer_id`	Código de autorizador. Debe tener el mismo valor que Logon.	< 4 N	SI
`acquirer_id`	Código de ruta que se utilizará en la transacción. Puede asumir los códigos descritos en la tabla Códigos de ruta. Caso este campo NOseja enviado, a configuração da autorizadora da loja será utilizada para definir o roteamento.	< 4 N	NO
`version`	Versión de las tablas de parámetros presentes en la red de captura referidas a un Autorizador. Cada autorizador tendrá una versión diferente de parámetros. Debe tener el mismo valor que elLogon NOTA: Si aún no hay mesas en el establecimiento, envíe ceros.	< 4 N	SI
`terminal`	Atributo de tipo terminal NOTA: solo el atributo `id` contenido en el atributo de tipo `terminal` es necesario en la Carga de Tablas.

Ejemplo de solicitud de Carga de Tablas#

curl
--request PUT "https://esitef-homologacao.softwareexpress.com.br/e-sitef/api/v1/acquirer_tables/<valor do acquirer_table.usn>"
--header "Content-Type: application/json"
--header "merchant_id: xxxxxxxx"
--header "merchant_key: xxxxxxxxxxx"
--data-binary
{
    "authorizer_id":"2",
    "version":"4",
    "terminal": {
        "id":"ES000001"
    }
}
--verbose

Respuesta de la Carga de Tablas#

Parámetro	Descripción	Formato
`code`	Código de respuesta de Pago Online. Cualquier código que no sea "0" significa error. Para obtener más información, consulte la sección [Códigos API].(codigos-da-api.md#códigos-de-resposta).	< 4 N
`message`	Mensaje de Respuesta del Pago Online.	< 500 AN
`acquirer_table`	Atributo de tipo acquirer_table

Ejemplo de Respuesta de Carga de Tablas#

{
  "code": "0",
  "message": "OK. Transaction successful.",
  "acquirer_table": {
    "code": "00",
    "message": "Sucesso",
    "acquirer_id": "5",
    "acquirer_name": "Redecard",
    "usn": "000230",
    "merchant_code": "000000000100250",
    "version": "40361885",
    "signature": "R8yxlnT24sSm1Zt77Jj44pohO8LapTNjWt1nqV8zGKg=",
    "date": "06/09/2018T11:41:49",
    "credit_bins": [
      {
        "bin": {
          "start": "549202000",
          "end": "549202999"
        },
        "brand_code": "005",
        "is_voucher": "N",
        "features": "24",
        "subtype": "00"
      },
      {
        "bin": {
          "start": "549221000",
          "end": "549221999"
        },
        "brand_code": "005",
        "is_voucher": "N",
        "features": "24",
        "subtype": "00"
      }
    ],
    "public_keys": [
      {
        "rid": "A000000004",
        "certification_authority_public_key_index": "F3",
        "certification_authority_public_key_exponent_size": "1",
        "certification_authority_public_key_exponent": "03",
        "certification_authority_public_key_modulus_size": "144",
        "certification_authority_public_key_modulus": "98F0C770F23864C2E",
        "checksum_status": "1",
        "certification_authority_public_key_checksum": "FCB86DA7076023DB8F38D992680175A839FFC9A6"
      },
      {
        "rid": "A000000004",
        "certification_authority_public_key_index": "F1",
        "certification_authority_public_key_exponent_size": "1",
        "certification_authority_public_key_exponent": "03",
        "certification_authority_public_key_modulus_size": "176",
        "certification_authority_public_key_modulus": "A0DCF4BDE19C3546B4B",
        "checksum_status": "1",
        "certification_authority_public_key_checksum": "55CD192717EE59A8E80A2B2D77528F6552F23BBE"
      }
    ],
    "emv_params": [
      {
        "aid_code": "01",
        "aid_length": "07",
        "aid": "A0000000041010                 ",
        "application_type": "01",
        "application_name": "                ",
        "default_value": "03",
        "version_opt1": "0002",
        "version_opt2": "0002",
        "version_opt3": "0002",
        "terminal_country_code": "076",
        "transaction_currency_code": "986",
        "transaction_currency_exponent": "2",
        "merchant_id": "000000000100250",
        "merchant_category_code": "0000",
        "terminal_id": "00000000",
        "terminal_capabilities": "E0F0C8",
        "terminal_capabilities_additional": "FF80B0F001",
        "terminal_type": "22",
        "terminal_action_code_default": "FE50BCA000",
        "terminal_action_code_denial": "0000000000",
        "terminal_action_code_online": "FE50BCF800",
        "terminal_floor_limit": "00000000",
        "transaction_category_code": "R",
        "tdol": "9F02065F2A029A039C0195059F37040000000000",
        "ddol": "9F37040000000000000000000000000000000000",
        "authorization_response_code_offline_approved": "Y1",
        "authorization_response_code_offline_declined": "Z1",
        "authorization_response_code_unable_online_offline_approved": "Y3",
        "authorization_response_code_unable_online_offline_declined": "Z3",
        "contactless_zero_amount": "1",
        "contactless_mode": "4",
        "contactless_transaction_limit": "05F5E0FF",
        "contactless_floor_limit": "00000000",
        "contactless_cvm_limit": "00001389",
        "contactless_application_version": "0000",
        "contactless_selection_mode": "1",
        "contactless_terminal_action_code_default": "FC509C8800",
        "contactless_terminal_action_code_denied": "0000000000",
        "contactless_terminal_action_code_online": "FC509C8800"
      },
      {
        "aid_code": "02",
        "aid_length": "07",
        "aid": "A0000000043060                  ",
        "application_type": "02",
        "application_name": "                ",
        "default_value": "03",
        "version_opt1": "0002",
        "version_opt2": "0002",
        "version_opt3": "0002",
        "terminal_country_code": "076",
        "transaction_currency_code": "986",
        "transaction_currency_exponent": "2",
        "merchant_id": "000000000100250",
        "merchant_category_code": "0000",
        "terminal_id": "00000000",
        "terminal_capabilities": "E0D0C8",
        "terminal_capabilities_additional": "FF80B0F001",
        "terminal_type": "22",
        "terminal_action_code_default": "FE50BCA000",
        "terminal_action_code_denial": "0000000000",
        "terminal_action_code_online": "FE50BCF800",
        "terminal_floor_limit": "00000000",
        "transaction_category_code": "R",
        "tdol": "9F02065F2A029A039C0195059F37040000000000",
        "ddol": "9F37040000000000000000000000000000000000",
        "authorization_response_code_offline_approved": "Y1",
        "authorization_response_code_offline_declined": "Z1",
        "authorization_response_code_unable_online_offline_approved": "Y3",
        "authorization_response_code_unable_online_offline_declined": "Z3",
        "contactless_zero_amount": "1",
        "contactless_mode": "4",
        "contactless_transaction_limit": "05F5E0FF",
        "contactless_floor_limit": "00000000",
        "contactless_cvm_limit": "00001389",
        "contactless_application_version": "0000",
        "contactless_selection_mode": "1",
        "contactless_terminal_action_code_default": "FC501C8800",
        "contactless_terminal_action_code_denied": "0000800000",
        "contactless_terminal_action_code_online": "FC501C8800"
      }
    ],
    "emv_tags": [
      {
        "aid_code": "46",
        "all_emv_tags": "9f269f109f379f36959c9f025f2a829f1a9f03"
      },
      {
        "aid_code": "45",
        "all_emv_tags": "9f269f109f379f36959c9f025f2a829f1a9f03"
      }
    ],
    "mandatory_emv_tags": [
      {
        "aid_code": "46",
        "mandatory_emv_tags": "9f269f109f379f36959c9f025f2a829f1a9f03"
      },
      {
        "aid_code": "45",
        "mandatory_emv_tags": "9f269f109f379f36959c9f025f2a829f1a9f03"
      }
    ],
    "optional_emv_tags": [
      {
        "aid_code": "46",
        "optional_emv_tags": "5f3484"
      },
      {
        "aid_code": "45",
        "optional_emv_tags": "5f3484"
      }
    ],
    "brand_per_credit_aid": [
      {
        "aid_code": "01",
        "brand_code": "002"
      },
      {
        "aid_code": "01",
        "brand_code": "004"
      }
    ],
    "brand_per_debit_aid": [
      {
        "aid_code": "02",
        "brand_code": "002"
      },
      {
        "aid_code": "02",
        "brand_code": "005"
      }
    ]
  }
}

Tipos de Datos#

`authorization_terminal`#

Parámetro	Descripción	Formato	Obligatorio
`usn`	NSU de la Terminal de Autorización de la transacción original	= 6 N	Cond.
`local_date_time`	Fecha y hora locales de la transacción original (formato 'MMddHHmmss')	= 10 N	Cond.

`authentication`#

Parámetro	Descripción	Formato	Obligatorio
`pin`	Atributo de tipo authentication.pin

`authentication`.`pin`#

Parámetro	Descripción	Formato	Obligatorio
`value`	PIN cifrado. Requerido al ingresar la contraseña en línea del titular de la tarjeta.	< 16	Cond.
`crypto`	Atributo de tipo pin.crypto

`pin`.`crypto`#

Parámetro	Descripción	Formato	Obligatorio
`type`	Proceso de cifrado de PIN. Puede asumir los valores de los códigos descritos en la tabla Códigos de proceso de cifrado. Requerido solo cuando se envía el PIN.	= 3	Cond.
`ksn`	Cifrado PIN KSN. Requerido al ingresar la contraseña en línea del titular de la tarjeta.	< 20 AN	Cond.

`terminal`#

Parámetro	Descripción	Formato	Obligatorio
`id`	Identificación del terminal.	< 8 AN	SI
`type`	Tipo de servicio de terminal. Puede asumir los valores de los códigos descritos en la tabla Códigos de tipo de servicio de terminal.	= 1 N	SI
`input_mode`	Capacidad de entrada de terminal. Puede asumir los valores de los códigos descritos en la tabla Códigos de capacidad de entrada del terminal.	= 2 N	SI
`pin_pad_physical_features`	Características físicas del PIN-pad. Puede asumir los valores de los códigos descritos en la tabla Códigos de características físicas del terminal.	= 1 N	SI
`handling_type`	Tipo de manejo de contraseñas. Puede tomar los valores de los códigos descritos en la tabla Tipo de códigos de manejo de contraseña.	= 1 N	SI
`reader_capabilities`	Habilitación de lectores de tarjetas. Puede asumir los valores de los códigos descritos en la tabla Códigos de activación del lector de tarjetas.	= 1 N	SI
`chip_conditions`	Condiciones de CHIP. Puede asumir los valores de los códigos descritos en la tabla Códigos de condición CHIP.	= 1 N	SI

`card`#

Parámetro	Descripción	Formato	Obligatorio
`service_code`	Service Code, campo obligatorio cuando el tipo de transacción es pista o chip. Este campo proporciona 3 posiciones, con los 3 dígitos después de la fecha de vencimiento de la pista 2, según el estándar ISO/IEC 7813. Ejemplo de pista 2: ;1234567890123445=99011200XXXX00000000?* Service Code: 120.	= 3 N	Cond.
`bin`	Tarjeta BIN, campo obligatorio para transacciones mecanografiadas, pista o chip. Este campo predice 6 posiciones, los primeros 6 dígitos después del centinela de inicio de la pista 2, según el estándar ISO/IEC 7813. Ejemplo de pista 2 ;1234567890123445=99011200XXXX00000000?* Tarjeta Bin: 123456.	= 6 N	Cond.
`last4`	Últimos 4 dígitos de la tarjeta, Campo obligatorio para transacciones mecanografiadas, pista o chip. Este campo prevé 4 posiciones, con los últimos 4 dígitos antes del separador ("=") de la pista 2, según norma ISO/IEC 7813. Ejemplo de pista 2 ;1234567890123445=99011200XXXX00000000?* 4 últimos dígitos: 3445.	= 6 N	Cond.
`track_1`	Inicio de la pista 1 encriptado, según la regla acordada entre Store y Software Express. Presente si lee la pista 1.	AN N/A	Cond.
`track_2`	Lectura del Track 2 de la tarjeta o identificación del cliente. Cifrado por hardware, como regla acordada entre Store y Software Express. Presente si pista 2.	< 99	Cond.
`subtype`	Subtipo de tarjeta. Puede asumir los valores de los códigos descritos en la tabla Códigos de Subtype. Obligatorio en caso de compra con tarjeta voucher.	= 2 AN	Cond.
`crypto`	Atributo de tipo card.crypto
`pin`	Atributo de tipo card.pin
`pos_entry_mode`	Atributo de tipo pos_entry_mode
`emv`	Atributo de tipo emv
`number`	Número de tarjeta (PAN). Usado en el (los) servicio (s) de: `Cancelamento`	LLvar n..99 N	Cond.
`expiry_date`	Fecha de vencimiento de la tarjeta. Usado en el (los) servicio (s) de: `Cancelamento`	= 4 N	Cond.
`security_code`	Código de Seguridad de la Tarjeta. Usado en el (los) servicio (s) de: `Cancelamento`	= 6 N	Cond.

`card`.`crypto`#

Parámetro	Descripción	Formato	Obligatorio
`ksn`	KSN (Key Serial Number) del cifrado PAN y pista 2 (campo card.track_2). Se utiliza en el cifrado DUKPT. Obligatorio cuando se utiliza el tipo de cifrado PAN / Track 2 DUKPT (004). Si está ausente, se asume el tipo de cifrado PAN 3DES (002).	= 20 AN	COND
`ksn_trac_1`	KSN (Número de serie de clave) del cifrado de la pista 1 (campo card.track_1). Se utiliza en el cifrado DUKPT. Obligatorio cuando se utiliza el tipo de cifrado DUKPT track 1 (004), si no está presente, se asume que FEPAS es el tipo de cifrado PAN 3DES (002).	= 20 AN	COND

`card`.`pin`#

Parámetro	Descripción	Formato	Obligatorio
`value`	PIN cifrado. Obligatorio al ingresar la contraseña en línea del titular de la tarjeta.	< 64	Cond.

`resp_card`#

Parámetro	Descripción	Formato
`token`	HASH de una tarjeta almacenada en Pago Online. NO está permitido enviar un número de tarjeta abierto. (campo 'number') y una tarjeta almacenada (campo 'token') en la misma solicitud.	= 88 AN
`par`	PAR (Payment Account Reference).	= 29 AN

`pos_entry_mode`#

Parámetro	Descripción	Formato	Obligatorio
`value`	Modo de entrada de tarjeta. Puede asumir los valores de los códigos descritos en la tabla Códigos de modo de entrada.	= 2 N	SI
`pin_capability`	Capacidad de terminal con respecto a la entrada de PIN. Puede asumir los valores de los códigos descritos en la tabla Códigos de capacidad de entrada PIN.	= 1 N	SI

`emv`#

Parámetro	Descripción	Formato	Obligatorio
`card_sequence_number`	Número de secuencia de la tarjeta. Corresponde a la copia de la tarjeta EMV en tratamiento (tag `5F34`). Enviar solo si la transacción realizada es con un chip EMV y la tarjeta informa esta información.	< 3 N	Cond.
`data`	Contiene las etiquetas EMV, en transacciones procesadas a través del chip EMV. Su contenido se envía en bytes en formato ASCII siguiendo el formato TLV: tipo, tamaño, contenido. Por ejemplo, si vamos a enviar: `Tag: 82` - (Application Interchange Profile), tamaño: 2, valor: 5800; `Tag: 9F27` - (Cryptogram Information Data), tamaño: 1, valor: 80; `Tag: 9F26` - (Application Cryptogram), tamaño: 8, valor: b42433f98916b331. El campo resultante se queda: "data":"820258009F2701809F2608B42433F98916B331"	< 999 N/A	Cond.

`mtt`#

Parámetro	Descripción	Formato	Obligatorio
`id`	ID de transacción MTT(Mass Transport Transaction). Informa el tipo de transacción solicitada. Puede asumir los valores de los códigos descritos en la tabla Códigos de ID de transacción MTT.	= 1 N	Cond.
`first_journey_date`	Fecha del primer viaje de transacción MTT. Siga el formato: `MMDD`.Requerido para MTT	= 4 N	Cond.
`vehicle_id`	Identificación del vehículo. Requerido para MTT	= 18 N	NO
`gps_location`	Ubicación GPS, debe enviarse en transacciones MTT con la ubicación del vehículo en latitud y longitud decimal, por ejemplo: 050.167958;-097.133000 (xxx.nnnnnn;-xxx.nnnnnn), donde: “xxx” – Coincidencias de grado; “.” – Separador de grados y minutos; “nnnnnn” – Minutos convertidos a fracción de grados; “;” – Separador de latitud y longitud; “-“ – Indicación de grados negativos.	< 24 AN	NO
`transport_mode_indicator`	Indicador de modo de transporte. Requerido para MTT. Tabla de indicadores de modo de transporte.	< = 2 N	NO

`payment`#

Parámetro	Descripción	Formato
`acquirer_table_load_required`	Informa si la Tienda necesita realizar una Carga de Tablas con Autorizador. `0` - Parámetros actualizados. `1` - Parámetros desactualizados: la tienda necesita realizar la Carga de Tablas.	= 1 N
`conciliation_authorizer_merchant_id`	Código de establecimiento de venta.	= 15
`authorization_terminal`	Atributo de tipo authorization_terminal

`pre_authorization`#

Parámetro	Descripción	Formato
`acquirer_table_load_required`	Informa si la Tienda necesita realizar un Cargamento de Tablas con Autorizador. `0` - Parámetros actualizados. `1` - Parámetros desactualizados: la tienda necesita cargar tablas.	= 1 N
`conciliation_authorizer_merchant_id`	Código de establecimiento de venta.	= 15
`authorization_terminal`	Atributo de tipo authorization_terminal

`cancellation`#

Parámetro	Descripción	Formato
`acquirer_table_load_required`	Informa si la Tienda necesita realizar una Carga de Tablas con Autorizador. `0` - Parámetros actualizados. `1` - Parámetros desactualizados: la tienda necesita realizar la Carga de Tablas.	= 1 N
`conciliation_authorizer_merchant_id`	Código de Estabelecimento da Venda.	= 15 N
`authorization_terminal`	Atributo de tipo authorization_terminal

`authorization_terminal`#

Parámetro	Descripción	Formato
`usn`	Terminal de autorización NSU.	= 6 N
`id`	Identificación del Terminal de Autorización.	= 8 AN

`acquirer_table`#

Parámetro	Descripción	Formato
`code`	Código de respuesta de operación en FEPAS.	= 2 AN
`message`	Mensage de respuesta de FEPAS.	< 999 AN
`usn`	NSU de la operación.	= 6 N
`date`	Fecha y hora local.	= 19 N
`authorizer_id`	Código de autorizador.	< 4 N
`merchant_code`	Código de establecimiento.	< 15 AN
`version`	Versión de las tablas de parámetros presentes en la red de captura referidas a un autorizador. Cada autorizador tendrá una versión diferente de los parámetros. NOTA: Si aún NO hay mesas en el establecimiento, se enviarán ceros.	< 8 N
`signature`	Identificação do Terminal da Autorização.	< 999 AN
`acquirer_id`	código del adquirente. Devuelto en el (los) servicio (s) de: `Carga de Tabelas`	< 4 N
`acquirer_name`	Nombre del adquirente. Devuelto en el (los) servicio (s) de: `Carga de Tabelas`	N/A AN
`credit_bins[]`	Atributo de tipo product_bins Devuelto en el (los) servicio (s) de: `Carga de Tabelas`
`debit_bins[]`	Atributo de tipo product_bins Devuelto en el (los) servicio (s) de: `Carga de Tabelas`
`emv_params[]`	Atributo de tipo emv_params Devuelto en el (los) servicio (s) de: `Carga de Tabelas`
`public_keys[]`	Atributo de tipo public_keys Devuelto en el (los) servicio (s) de: `Carga de Tabelas`
`mandatory_emv_tags[]`	Atributo de tipo mandatory_emv_tags Devuelto en el (los) servicio (s) de: `Carga de Tabelas`
`optional_emv_tags[]`	Atributo de tipo OPTIONAL_EMV_TAGS Devuelto en el (los) servicio (s) de: `Carga de Tabelas`
`emv_tags[]`	Atributo de tipo emv_tags Devuelto en el (los) servicio (s) de: `Carga de Tabelas`
`brand_per_credit_aid[]`	Atributo de tipo brand_per_x_aid Devuelto en el (los) servicio (s) de: `Carga de Tabelas`
`brand_per_debit_aid[]`	Atributo de tipo brand_per_x_aid Devuelto en el (los) servicio (s) de: `Carga de Tabelas`

`product_bins`#

Parámetro	Descripción	Formato
`brand_code`	Contiene el código que identifica la bandera de Range. Puede asumir los valores de los códigos descritos en la tabla Códigos de bandera.	= 2 AN
`is_voucher`	Informar si la tarjeta es del tipo Voucher. Valores posibles: `S` - SI `N` - NO	= 1 AN
`features`	Mapa de bits que consta de 1 byte binario (2 caracteres ASCII hexadecimal) indicando las características del cobro de la transacción. La posición 8 corresponde al bit más significativo. Si el bit está activado, se habilitará la funcionalidad correspondiente. Orden de bytes: 87654321 La relación de bits se puede consultar en el Mapa de Features.	= 2 AN
`subtype`	Subtipo de tarjeta. Puede asumir los valores de los códigos descritos en la tabla Códigos de Subtype.	= 2 AN
`bin`	Atributo de tipo bin

`bin`#

Parámetro	Descripción	Formato
`start`	Contiene el BIN inicial del Range.	= 9 N
`end`	Contiene el BIN final del Range (este campo es el mismo que el anterior cuando el tratamiento individual BIN).	= 9 N

`emv_params`#

Parámetro	Descripción	Formato
`aid_code`	Código de AID.	= 2 N
`aid_length`	Tamaño del AID, en bytes (de `05` a `16`).	= 2 N
`aid`	AID - Application Identifier (alineado a la izquierda).	= 32 H
`application_type`	Tipo de Aplicacion. Valores posibles: `01` - Crédito `02` - Débito	= 2 N
`application_name`	Etiqueta default de la aplicación	= 61 AN
`default_value`	Patrón de aplicación. `03` - EMV.	= 2 N
`version_opt_1`	Application Version Number (Terminal) - opción `#1`.	= 4 h
`version_opt_2`	Application Version Number (Terminal) - opción `#2`.	= 4 h
`version_opt_3`	Application Version Number (Terminal) - opción `#3`.	= 4 h
`terminal_country_code`	Terminal Country Code.	= 3 N
`transaction_currency_code`	Transaction Currency Code.	= 3 N
`transaction_currency_exponent`	Transaction Currency Exponent.	= 1 N
`merchant_id`	Merchant Identifier.	= 15 AN
`merchant_category_code`	Merchant Category Code.	= 4 N
`terminal_id`	Terminal Identification.	= 8 AN
`terminal_capabilities`	Terminal Capabilities. Es el mapa de bits que indica las capacidades del terminal. El formato y los valores se pueden encontrar en el Mapa de Capacidades del Terminal..	= 6 H
`terminal_capabilities_additional`	Additional Terminal Capabilities.	= 10 H
`terminal_type`	Terminal Type. Puede asumir los valores de los códigos descritos en la tabla Códigos de Tipo del Terminal.	= 2 N
`terminal_action_code_default`	Terminal Action Code - `Default`.	= 10 H
`terminal_action_code_denial`	Terminal Action Code – `Denial`.	= 10 H
`terminal_action_code_online`	Terminal Action Code – `Online`.	= 10 H
`terminal_floor_limit`	Terminal Floor Limit.	= 8 H
`transaction_category_code`	Transaction Category Code.	= 1 AN
`tdol`	Transaction Category Code. Default Transaction Certificate Data Object List (TDOL) (completado com bytes "00" à direita).	= 40 H
`ddol`	Default Dynamics Data Authentication Data Object List (DDOL) (completado com bytes "00" à direita).	= 40 H
`authorization` `_response_code` `_offline_approved`	Authorization Response Code - offline approved.	= 2 AN
`authorization` `_response_code` `_offline_declined`	Authorization Response Code - offline declined.	= 2 AN
`authorization` `_response_code` `_unable_online_offline_approved`	Authorization Response Code - unable to go online - offline approved.	= 2 AN
`authorization` `_response_code` `_unable_online_offline_declined`	Authorization Response Code - unable to go online - offline declined.	= 2 AN
`contactless_zero_amount`	Indica a ação para cartão com chip sem contato se o valor da transação estiver zerado. Valores posibles: `0` - NO soporta. `1` - Admite, pero solo en línea.	= 1 N
`contactless_mode`	Capacidad de manejo de terminal para ese AID, si está ubicado en una tarjeta con chip sin contacto. Puede asumir los valores de los códigos descritos en la tabla Códigos de Capacidade de Tratamiento del Terminal.	= 1 N
`contactless_transaction_limit`	Terminal/Reader Contactless Transaction Limit.	= 8 H
`contactless_floor_limit`	Terminal/Reader Contactless Floor Limit.	= 8 H
`contactless_cvm_limit`	Terminal/Reader CVM Required Limit.	= 8 H
`contactless_application_version`	PayPass Mag Stripe Application Version Number (Terminal).	= 4 H
`contactless_selection_mode`	Indica a forma de seleção da aplicação do cartão sem contato. Valores possíveis: `0` - A aplicação é selecionada automaticamente pela prioridade. `1` - Deve ser mostrado menu de seleção caso exista outra aplicação compatível.	= 1 N
`contactless` `_terminal_action` `_code_default`	Terminal Action Code – `Default` (para tarjetas sin contacto).	= 10 H
`contactless` `_terminal_action` `_code_denied`	Terminal Action Code – `Denied` (para tarjetas sin contacto).	= 10 H
`contactless` `_terminal_action` `_code_online`	Terminal Action Code – `Online` (para tarjetas sin contacto).	= 10 H

`public_keys`#

Parámetro	Descripción	Formato
`rid`	RID - Registered Application Provider Identifier.	= 10 H
`certification_authority` `_public_key_index`	Certification Authority Public Key Index.	= 2 H
`certification_authority` `_public_key_exponent_size`	Tamaño en bytes del Certification Authority Public Key Exponent (`1` ou `3`).	= 1 N
`certification_authority` `_public_key_exponent`	Certification Authority Public Key Exponent (alineado a la izquierda).	= 6 H
`certification_authority` `_public_key_modulus_size`	Tamanho em bytes do Certification Authority Public Key Modulus (hasta `248`).	= 3 N
`certification_authority` `_public_key_modulus`	Certification Authority Public Key Modulus (alineado a la izquierda).	= 496 H
`checksum_status`	Status del Check Sum (Hash SHA-1). Valores posibles: `0` - NO utilizado. `1` - Presente.	= 1 N
`certification_authority` `_public_key_checksum`	Certification Authority Public Key Check Sum (Hash SHA-1).	= 40 h

`mandatory_emv_tags`#

Parámetro	Descripción	Formato
`aid_code`	Código AID.	= 2 N
`mandatory_emv_tags`	Contiene la lista de etiquetas EMV obligatorias que se enviarán en los datos EMV de los mensajes de aviso o solicitud de transacción de flujo EMV completo, tanto en línea como fuera de línea, después de la First Generate AC. Ejemplo: `9F269F27959F10`.	N/A AN

`optional_emv_tags`#

Parámetro	Descripción	Formato
`aid_code`	Código AID.	= 2 N
`optional_emv_tags`	Contiene la lista de etiquetas EMV opcionales que se enviarán en los datos EMV de los mensajes de aviso o solicitud de transacción de flujo EMV completo, tanto en línea como fuera de línea, después de la First Generate AC.	N/A AN

`emv_tags`#

Parámetro	Descripción	Formato
`aid_code`	Código AID.	= 2 N
`all_emv_tags`	Contiene la lista de Etiquetas EMV a enviar en el Bit 55 de la Confirmación de Transacción o mensajes de aviso del Flujo EMV Completo, tanto online como offline, después de la Second Generate AC. Exemplo: `9F269F27959F10`.	N/A AN

`brand_per_x_aid`#

Parámetro	Descripción	Formato
`aid_code`	Código AID.	= 2 N
`brand_code`	Contiene el código AID.	= 3 N

Tablas & Mapas#

Códigos de Enrutamiento#

Código	Descripción
`2005`	Rede
`2013`	GoodCard
`2047`	Sorocred
`2052`	Tricard
`2054`	Up Brasil
`2072`	Bigcard
`2077`	Valecard
`2094`	Cabal
`2125`	Cielo
`2201`	VR
`2206`	Global Payments
`2265`	Stone
`2309`	Adiq
`5001`	Alelo

Códigos de Bandera#

Código	Descripción
`001`	Visa
`002`	Mastercard
`003`	Amex
`005`	Hipercard
`006`	Diners
`008`	JCB
`012`	Sorocred
`014`	Policard
`016`	Elo
`017`	Cabal
`043`	Tricard
`054`	Valecard
`058`	VR
`065`	Alelo
`158`	Bigcard
`235`	Up
`999`	Bandeira desconhecida

Mapa de Features#

Regla de recopilación de contraseñas con seguimiento activado Compra:

Compruebe si el código de servicio está activado (bit 8);
Si es así, utilice el código de servicio. para determinar la recopilación de contraseñas; o
De lo contrario, utilice el bit 7 para determinar la colección de contraseñas.

Regla de recopilación de contraseñas con seguimiento activado Cancelación:

Compruebe si el código de servicio está activado (bit 8);
Si es así, utilice el código de servicio. para determinar la recopilación de contraseñas; o
De lo contrario, utilice el bit 6 para determinar la colección de contraseñas.

Tabla para el byte 1#

Bit	Descripción
`8`	Permite la entrada escrita.
`7`	Solicita los últimos 4 dígitos (pista).
`6`	Permite retroceso magnético.
`5`	Permite retroceso escrito.
`4`	Reservado para uso futuro.
`3`	Solicitudes de transacciones magnéticas CVV2 / CVC2.
`2`	Solicitar código de seguridad (ingresado).
`1`	Permite CVV inexistente o ilegible.

Tabla para Byte 2#

Bit	Descripción
`8`	Utilice el código de servicio para determinar si debe solicitar una contraseña (seguimiento).
`7`	Solicita la contraseña (pista).
`6`	Solicitar contraseña en cancelación (pista).
`5`	Solicita la contraseña (ingresada).
`4`	Solicitar NIE (DNI para Argentina).
`3`	Solicite el código del plan.
`2`	Solicite el tipo de cuenta (corriente o de ahorro).
`1`	Valida la fecha de vencimiento de la tarjeta.

Tabla para Byte 3#

Bit	Descripción
`8`	Requiere código de seguridad para pago de factura magnética (pista).
`7`	Solicitar código de seguridad para el pago de la factura ingresada.
`6`	Permite código de seguridad inexistente o ilegible para el pago de facturas.
`5`	Procesar chip en cancelación.
`4`	Procesar chip en el pago de la factura.
`3`	Reservado para uso futuro.
`2`	Reservado para uso futuro.
`1`	Reservado para uso futuro.

Códigos de Subtype#

Código	Descripción
`00`	La tarjeta NO es un débito/voucher
`01`	Débito/Voucher Alimentación
`02`	Débito/Voucher Comida
`03`	Débito/Voucher Cultura
`04`	Débito/Voucher Combustible
`05`	Débito/Voucher Beneficio
`19`	Débito/Voucher Otros (indefinido)
`25`	Débito/PEI (Pagos Electrónicos Instantáneos)

Mapa de Capacidades del Terminal#

Formato:

ABCxxxxx DEFGKxxx HIJMxxxx

Posición	Descripción
`A`	Escribir el número de la tarjeta.
`B`	Tarjeta magnética.
`C`	Tarjeta con chip de contacto.
`D`	Verificación de tarjeta con chip PIN "Abrir".
`Y`	Verificación de PIN en línea con cifrado.
`F`	Firma en papel.
`G`	Verificación en tarjeta con chip PIN cifrado.
`K`	Acepta el método "Sin CVM" (sin verificación del titular).
`H`	SDA: autenticación estática de los datos de la tarjeta con chip.
`I`	DDA: autenticación dinámica de los datos de la tarjeta con chip.
`J`	Captura de tarjeta.
`M`	Autenticación CDA sin conexión.

Códigos de Tipo del Terminal#

Código	Descripción
`21`	En línea.
`22`	Fuera de línea con capacidad en línea.
`23`	Solo sin conexión.
`24`	En línea, NO atendido.
`25`	Fuera de línea con capacidad en línea, NO atendido.
`26`	Solo fuera de línea, NO reparado.

Códigos de Capacidade de Tratamiento del Terminal#

Código	Descripción
`0`	NO soporta.
`1`	soporta VISA MSD.
`2`	soporta VISA qVSDC.
`3`	soporta MasterCard PayPass Mag Stripe.
`4`	soporta MasterCard PayPass M/Chip.
`5`	soporta Amex Expresspay Magstripe Mode.
`6`	soporta Amex Expresspay EMV Mode.

Códigos de proceso de Cifrado#

Código	Descripción
`001`	3DES entre la tienda y el autorizador (bypass Software Express).
`002`	3DES entre Tienda y Express Software, que realiza la translate para el Autorizador.
`003`	DUKPT 3DES entre la tienda y el Autorizador (bypass Software Express).
`004`	DUKPT 3DES entre Tienda y Express Software, que realiza la translate para el Autorizador.

Códigos de Tipo de Servicio de Terminal#

Código	Descripción
`0`	Terminal con Servicio (el establecimiento cuenta con operador para la terminal).
`2`	Terminal de autoservicio.

Códigos de Capacidad de Entrada del Terminal#

Código	Descripción
`0`	Indefinido.
`2`	Sin terminal (URA / Voice).
`5`	Lector de chips.

Códigos de Características Físicas del Terminal#

Código de posición 1	Descripción
`1`	Sin PIN-pad
`3`	PIN-pad con lector de chip.
`6`	PIN-pad con chip sin contacto y lector de tarjetas.

Código de posición 2	Descripción
`0`	PIN-pad sin lector magnético.
`1`	PIN-pad con lector magnético.

Códigos de Tipo de manejo de Contraseñas#

Código	Descripción
`1`	Sin contraseña.
`2`	Contraseña en línea.
`3`	Contraseña sin conexión.

Códigos de Activación del Lector de Tarjetas#

Código	Descripción
`4`	Lector de bandas y chip habilitados.
`5`	Lector de bandas y tarjeta sin contacto habilitados.
`6`	Lector de tarjetas y chip sin contacto habilitado.
`7`	Lector de bandas, chip y tarjeta sin contacto habilitados. PIN-pad con lector de chip.

Códigos de Condiciones del CHIP#

Código	Descripción
`1`	Pista sin fallback.
`2`	Pista con fallback.

Códigos de Modo de Entrada#

Código	Descripción
`01`	Entrada manual del número de tarjeta (ingresado).
`02`	Banda magnética.
`05`	Chip.
`07`	Contactless chip.
`81`	Fallback para banda magnética (se utiliza cuando falla la lectura del chip y la posición 1 del Service Code de la Pista = 2 o 6, tarjeta con chip de señalización).
`89`	E-commerce
`91`	Contactless banda magnética.

Códigos de Capacidad de Entrada PIN#

Código	Descripción
`0`	No aplicable
`1`	Tiene capacidad de ingreso de PIN;
`2`	NO tiene la capacidad de ingresar un PIN.

Códigos ID de Transacción MTT#

Código	Descripción
`1`	AVR (la transacción debe venir con el valor restablecido).
`2`	Transacción de valor agregado: crédito, preautorización o débito.
`3`	Debt Recovery (reenvío, requerido para enviar el campo `resubmission_id`).
`4`	Debt Recovery e-commerce/MOTO (para transacciones digitadas).
`5`	Debt Recovery tap online (para transacciones contactless).
`6`	KFT (Transacción de tarifa conocida). Este modelo acepta transacciones de crédito o débito
`7`	Recuperación de deuda toque en línea para KFT.
`8`	Actualización de ATC (transacción de valor cero).

Pin de códigos de capacidad de entrada#

Código	Descripción
`0`	No aplicable
`1`	Tiene capacidad de entrada de PIN
`2`	Sin capacidad de entrada de PIN

Tabla de indicadores de modo de transporte#

Código	Descripción
`00`	Desconocido
`01`	Autobús urbano
`02`	Bus interurbano
`03`	Subterraneo
`04`	Tren colectivo
`05`	Trem
`06`	Vehículo de transporte de agua
`07`	Peaje
`08`	Estacionamiento
`09`	Taxi
`10`	Tren de alta velocidad
`11`	Bus rural
`12`	Tren expreso
`13`	Vehículo de tránsito
`14`	Vehículo autónomo
`15`	Vehículo de entrenamiento
`16`	Locomotora
`17`	Vehículo de motor
`18`	Remolque
`19`	Tren regional
`20`	Transporte entre ciudad
`21`	Tren funicular
`22`	Tranvía

Home

Interfaces Pago Online apoyado para la integración#

Pago REST#

Efectividad de pago REST#

Solicitud de pago#

Ejemplo de solicitud de pago#

Respuesta de pago#

Ejemplo de respuesta de pago#

Confirmación de pago REST#

Solicitud de confirmacion#

Ejemplo de solicitud de confirmación#

Respuesta de confirmación#

Ejemplo de respuesta de confirmación#

Cancelación de REST#

Efectividad de cancelación de REST#

Solicitud de cancelacion#

Ejemplo de solicitud de cancelación#

Respuesta de Cancelación#

Ejemplo de respuesta de cancelación#

Preautorización REST#

Efectividad de preautorización REST#

Solicitud de Preautorización#

Ejemplo de solicitud de Preautorización#

Responde desde Preautorización#

Ejemplo de respuesta de Preautorización#

Captura de Preautorización REST#

Ejemplo de solicitud de Captura de Preautorización#

Respuesta de Captura de Preautorización#

Ejemplo de respuesta de Captura de Preautorización#

Logon REST#

Solicitud de Logon#

Ejemplo de solicitud de Logon#

Respuesta de Logon#

Ejemplo de respuesta de Logon#

Carga de tablas REST#

Solicitud de Carga de Tablas#

Ejemplo de solicitud de Carga de Tablas#

Respuesta de la Carga de Tablas#

Ejemplo de Respuesta de Carga de Tablas#

Tipos de Datos#

authorization_terminal#

authentication#

authentication.pin#

pin.crypto#

terminal#

card#

card.crypto#

card.pin#

resp_card#

pos_entry_mode#

emv#

mtt#

payment#

pre_authorization#

cancellation#

authorization_terminal#

acquirer_table#

product_bins#

bin#

emv_params#

public_keys#

mandatory_emv_tags#

optional_emv_tags#

emv_tags#

brand_per_x_aid#

Tablas & Mapas#

Códigos de Enrutamiento#

Códigos de Bandera#

Mapa de Features#

Tabla para el byte 1#

Tabla para Byte 2#

Tabla para Byte 3#

Códigos de Subtype#

Mapa de Capacidades del Terminal#

Códigos de Tipo del Terminal#

Códigos de Capacidade de Tratamiento del Terminal#

Códigos de proceso de Cifrado#

Códigos de Tipo de Servicio de Terminal#

Códigos de Capacidad de Entrada del Terminal#

Códigos de Características Físicas del Terminal#

`authorization_terminal`#

`authentication`#

`authentication`.`pin`#

`pin`.`crypto`#

`terminal`#

`card`#

`card`.`crypto`#

`card`.`pin`#

`resp_card`#

`pos_entry_mode`#

`emv`#

`mtt`#

`payment`#

`pre_authorization`#

`cancellation`#

`authorization_terminal`#

`acquirer_table`#

`product_bins`#

`bin`#

`emv_params`#

`public_keys`#

`mandatory_emv_tags`#

`optional_emv_tags`#

`emv_tags`#

`brand_per_x_aid`#