GetnetLac

En este ítem, se presentarán características específicas para el enrutamiento GetnetLac a través de SiTef.

Autorización previa#

Sobre la preautorización enrutada por GetnetLac, la información de las cuotas (installments y installment_type) siempre debe pasarse en el paso de preautorización, no en la captura. Si la preautorización está a la vista, la captura no se puede dividir.
Para esta ruta, el plazo de preautorización siempre será sin intereses , es decir, install_type = 4. Esto se aplica a las interfaces HTML y REST.

Split Pago#

No Split Pago, la información sobre la división de valores entre los subvendedores se envía mediante una sola transacción en Portal Carat, y la distribución de los fondos es responsabilidad del adquirente.

El enrutamiento de GetnetLac permite que Split Pago se realice al incluir parámetros en el objeto additional_data al crear la transacción de pago, para las interfaces de pago HTML y REST.

parámetros de solicitud#

Parámetro	Descripción	Formato	Requerido
additional_data.split_request	Elemento con datos divididos
`seller_id`	Identificador de vendedor en la plataforma MarketPlace Getnet.	< 36 A	SI
`sale_id`	Identificador de venta o pedido.	< 36 A	SÍ
additional_data.split_request.subsellers[]	Lista con datos de subvendedores.
`id`	ID de proveedor secundario en la plataforma MarketPlace Getnet.	< 36 A	SI
`sales_amount`	Parte del Valor correspondiente al Subvendedor - en centavos.	< 12 N	SI
additional_data.split_request.subsellers.products[]	Lista con datos del artículo.
`product_id`	Identificador de artículo.	< 15 A	SI
`amount`	Valor del artículo en centavos.	< 12 N	SÍ
`description`	Descripción del Artículo.	< 80 A	SI
`tax_percent`	Tasa de artículo en porcentaje. Formato `NNNDDDDDD` donde: `NNN` Parte entera - completa con ceros a la izquierda hasta llegar a 3 dígitos; `DDDDDD` Parte fraccionaria. Completar con ceros a la derecha hasta llegar a 6 dígitos.	< 9 A	NO
`tax_amount`	Tarifa de valor del artículo en centavos.	< 12 N	NO

Pago HTML#

Ejemplo JSON: creación de transacciones#

Nota: Los valores de los ejemplos son ficticios.

{
  "merchant_id":"Codigo_Loja",
  "merchant_usn":"12345678",
  "order_id":"order_12345",
  "amount":"5000",
  "additional_data":{
    "split_request":{
      "seller_id":"6eb2412c-165a-41cd-b1d9-76c575d70a28",
      "sale_id":"6d2e4380-d8a3-4ccb-9138-c289182818a3",
      "subsellers":[
        {
          "id":"853984759834734",
          "sales_amount":"3700",
          "products":[
            {
              "product_id":"X0001",
              "amount":"1500",
              "description":"DESCRICAO PRODUTO 1",
              "tax_percent":"005934500",
              "tax_amount":"150"
            },
            {
              "product_id":"X0001",
              "amount":"1500",
              "description":"DESCRICAO PRODUTO 2",
              "tax_percent":"005934500",
              "tax_amount":"150"
            }
          ]
        },
        {
          "id":"256714932547251",
          "sales_amount":"1300",
          "products":[
            {
              "product_id":"X0003",
              "amount":"1300",
              "description":"DESCRICAO PRODUTO 3",
              "tax_percent":"005934500",
              "tax_amount":"150"
            }
          ]
        }
      ]
    }
  }
}

Una vez completado el Pago HTML, los siguientes parámetros se agregarán al Aviso de estado (más información):

Parámetro	Descripción	Formato
`splitPaymentId`	Identificador de pago split.	< 36 A
`splitTransactionId`	Identificador de transacción split.	< 19 N

Pago REST#

Ejemplo JSON#

Nota: Los valores de los ejemplos son ficticios.

Solicitud de creación de transacción

curl
--request POST "https://esitef-homologacao.softwareexpress.com.br/e-sitef/api/v1/transactions"
--header "Content-Type: application/json"
--header "merchant_id: xxxxxxxx"
--header "merchant_key: xxxxxxxxxxx"
--data-binary
{
  "merchant_usn":"12345678",
  "order_id":"order_12345",
  "installments":"1",
  "installment_type":"4",
  "authorizer_id":"1",
  "amount":"5000",
  "additional_data":{
    "split_request":{
      "seller_id":"6eb2412c-165a-41cd-b1d9-76c575d70a28",
      "sale_id":"6d2e4380-d8a3-4ccb-9138-c289182818a3",
      "subsellers":[
        {
          "id":"853984759834734",
          "sales_amount":"3700",
          "products":[
            {
              "product_id":"X0001",
              "amount":"1500",
              "description":"DESCRICAO PRODUTO 1",
              "tax_percent":"005934500",
              "tax_amount":"150"
            },
            {
              "product_id":"X0001",
              "amount":"1500",
              "description":"DESCRICAO PRODUTO 2",
              "tax_percent":"005934500",
              "tax_amount":"150"
            }
          ]
        },
        {
          "id":"256714932547251",
          "sales_amount":"1300",
          "products":[
            {
              "product_id":"X0003",
              "amount":"1300",
              "description":"DESCRICAO PRODUTO 3",
              "tax_percent":"005934500",
              "tax_amount":"150"
            }
          ]
        }
      ]
    }
  }
}
--verbose

Respuesta al efecto de pago

{
  "code":"0",
  "message":"OK. Transaction successful.",
  "payment":{
    "authorizer_code":"000",
    "authorizer_message":"Transacao OK                                                    SDO DISPONIVEL                                                   244,00",
    "status":"CON",
    "nit":"xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
    "order_id":"order_12345",
    "customer_receipt":"*****",
    "merchant_receipt":"*****",
    "authorizer_id":"1",
    "acquirer_id":"181",
    "acquirer_name":"GetNet Lac",
    "authorizer_date":"12/08/2020T14:24",
    "authorization_number":"122641",
    "merchant_usn":"12345678",
    "esitef_usn":"200812055315840",
    "sitef_usn":"122641",
    "host_usn":"008122641   ",
    "amount":"5000",
    "payment_type":"C",
    "issuer":"1",
    "authorizer_merchant_id":"000000000000000",
    "terminal_id":"ES000054",
    "payment_date":"12/08/2020T14:24",
    "split":{
      "payment_id":"06f256c8-1bbf-42bf-93b4-ce2041bfb87e",
      "transaction_id":"0023972834623476365"
    }
  }
}

Devoluciones específicas desde el pago dividido hasta el pago REST#

Parámetro	Descripción	Formato
payment.split	Elemento con datos de devolución de pago split
`payment_id`	identificador de pago split.	< 36 A
`transaction_id`	identificador de transacción split.	< 19 N

Home