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 (
installmentsyinstallment_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 |