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
andinstallment_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 be4
. 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 e-SiTef, 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
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 |