GetnetLac

Neste item serão apresentadas caracteristicas especificas para o roteamento GetnetLac via SiTef.

Pré-Autorização#

Sobre a pré-autorização roteada pela GetnetLac, a informação de parcelamento (installments e installment_type) deve ser sempre passada na etapa de pré-autorização, e não na captura. Caso a pré-autorização seja a vista, a captura não pode ser parcelada.
Para este roteamento, o parcelamento de pré-autorizações sempre será sem juros, isto é, installment_type= 4. Isto vale para as Interfaces HTML e REST.

Split de Pagamento#

No Split de Pagamento, as informações de divisão de valores entre os sub-vendedores são enviados por uma transação única no Carat, e a distribuição de fundos fica a cargo da adquirente.

O roteamento GetnetLac permite que seja feito o Split de Pagamento através da inclusão de parâmetros no objeto additional_data na criação da transação de pagamento, tanto para interfaces de Pagamento HTML e REST.

Parâmetros de requisição#

Parâmetro	Descrição	Formato	Obrigatório
additional_data.split_request	Elemento com os dados do split
`seller_id`	Identificador do vendedor na plataforma MarketPlace Getnet.	< 36 A	SIM
`sale_id`	Identificador da venda ou pedido.	< 36 A	SIM
additional_data.split_request.subsellers[]	Lista com dados dos sub-vendedores.
`id`	Id do Sub-vendendor na plataforma MarketPlace Getnet.	< 36 A	SIM
`sales_amount`	Parte do Valor correspondente ao Sub-vendedor - em centavos.	< 12 N	SIM
additional_data.split_request.subsellers.products[]	Lista com dados dos itens.
`product_id`	Identificador do Item.	< 15 A	SIM
`amount`	Valor do Item em centavos.	< 12 N	SIM
`description`	Descrição do Item.	< 80 A	SIM
`tax_percent`	Taxa do item em porcentagem. Formato `NNNDDDDDD` onde: `NNN` Parte inteira - completar com zeros a esquerda até atingir 3 dígitos; `DDDDDD` Parte fracionária. Completar com zeros a direita até atingir 6 dígitos.	< 9 A	NÃO
`tax_amount`	Taxa do item em valor em centavos.	< 12 N	NÃO

Pagamento HTML#

Exemplo de JSON - criação de transação#

Obs: Os valores dos exemplos são fictícios.

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

Após a finalização do Pagamento HTML, os seguintes parâmetros serão adicionados ao Aviso de Status (saiba mais):

Parâmetro	Descrição	Formato
`splitPaymentId`	Identificador do pagamento split.	< 36 A
`splitTransactionId`	Identificador da transação split.	< 19 N

Pagamento REST#

Exemplo de JSON#

Obs: Os valores dos exemplos são fictícios.

Requisição de criação de transação

Para usar este exemplo, não esquecer de definir a variável {{url}} com o valor
esitef-homologacao.softwareexpress.com.br

curl
--request POST "https://{{url}}/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

Resposta da efetivação de pagamento

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

Retornos específicos do Pagamento Split no Pagamento REST#

Parâmetro	Descrição	Formato
payment.split	Elemento com os dados de retorno de pagamento split
`payment_id`	Identificador do pagamento split.	< 36 A
`transaction_id`	Identificador da transação split.	< 19 N

Home