GetnetLac

This item will display specific characteristics for the GetnetLac via SiTef routing.

Pre-Authorization#

In GetnetLac routed pre-authorizations then installment-related fields(installments and installment_type) must always be sent in pre-authorization step, not in capture. In case of spot pre-authorization, capture can't apply installments.
Also in this routing, the allowed installment type is only without interest, so the installment_type must be 4. It applies in HTML and REST Interfaces .

Payment Split#

In Payment Split, the amount division between sub-sellers is sent by one singular transaction in Carat Portal, and the acquirer manage the funds distribution.

GetnetLac routing allows Payment Split by passing parameters in the additional_data object when creating the payment transaction, either in HTML and REST Payment interfaces.

Request parameters#

Parameter	Description	Format	Mandatory
additional_data.split_request This element contains split's data fields.
`seller_id`	Seller's identification in MarketPlace Getnet platform.	< 36 A	YES
`sale_id`	Sale or Order identification.	< 36 A	YES
additional_data.split_request.subsellers[] This element contains sub-seller's data.
`id`	Sub-seller's id in MarketPlace Getnet platform.	< 36 A	YES
`sales_amount`	Sub-seller's amount of the purchase - in cents.	< 12 N	YES
additional_data.split_request.subsellers.products[] Lista com dados dos itens.
`product_id`	Product's id.	< 15 A	YES
`amount`	Product's value in cents.	< 12 N	YES
`description`	Product's description.	< 80 A	YES
`tax_percent`	Product's taxes in percentage. `NNNDDDDDD` format: `NNN` integer part - complete with zeros in left side until the total of 3 characters; `DDDDDD` fractionary part -complete with zeros in right side until the total of 6 characters.	< 9 A	NO
`tax_amount`	Product's taxes value in cents.	< 12 N	NO

HTML Payment#

JSON's example - transaction creation#

Note: The example's values are fictitious.

{
  "merchant_id":"Merchant_ID",
  "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":"PRODUCT DESCRIPTION 1",
              "tax_percent":"005934500",
              "tax_amount":"150"
            },
            {
              "product_id":"X0001",
              "amount":"1500",
              "description":"PRODUCT DESCRIPTION 2",
              "tax_percent":"005934500",
              "tax_amount":"150"
            }
          ]
        },
        {
          "id":"256714932547251",
          "sales_amount":"1300",
          "products":[
            {
              "product_id":"X0003",
              "amount":"1300",
              "description":"PRODUCT DESCRIPTION 3",
              "tax_percent":"005934500",
              "tax_amount":"150"
            }
          ]
        }
      ]
    }
  }
}

After the finish of HTML Payment, the fields below will be added to Status Notification (learn more):

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

REST Payment#

JSON Example#

Note: The example's values are fictitious.

Transaction Creation Request

To use this example, don't forget to define the variable {{url}} with the value
esitef-homologacao.softwareexpress.com.br

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":"PRODUCT DESCRIPTION 1",
              "tax_percent":"005934500",
              "tax_amount":"150"
            },
            {
              "product_id":"X0001",
              "amount":"1500",
              "description":"PRODUCT DESCRIPTION 2",
              "tax_percent":"005934500",
              "tax_amount":"150"
            }
          ]
        },
        {
          "id":"256714932547251",
          "sales_amount":"1300",
          "products":[
            {
              "product_id":"X0003",
              "amount":"1300",
              "description":"PRODUCT DESCRIPTION 3",
              "tax_percent":"005934500",
              "tax_amount":"150"
            }
          ]
        }
      ]
    }
  }
}
--verbose

Payment Effectuation Response

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

Split Payment specific response fields in REST Payment#

Parameter	Description	Format
payment.split This element contains split's data fields.
`payment_id`	Split payment's id.	< 36 A
`transaction_id`	Split transaction's id.	< 19 N

Home