Response Structure

Description: This object represents the response of a transaction list.

{
"status": 200,
"timestamp": "18148517815",
"page": "1",
"items_per_page": "100",
"transactions": [
{
"cod_sit": 5,
"transaction_date": "2023-10-01",
"nsu_sitef": "1234567890",
"sitef_store_code": "001",
"trunk_store_code": "002",
"transaction_time": "12:34:56",
"transaction_value": "100.00",
"transaction_type": "SALE",
"response_code": "00",
"transaction_status_code": "APPROVED",
"authorization_code": "AUTH123",
"cupom_fiscal": "CF123456",
"card_type": "VISA",
"transaction_info": "Additional info",
"document": "DOC123456",
"installments_number": "1",
"pos_number": "POS001",
"nsu_host": "HOST123456",
"nsu_host_original": "HOST654321",
"input_mode": "CHIP",
"establishment_code": "EST001",
"cnpj": "12345678000195",
"network_description": "Network description",
"client_code": "CLIENT001",
"denied_by": "None",
"fiscal_date": "2023-10-01",
"fiscal_time": "12:34:56",
"codcli": "CODCLI001",
"mobile_operator_code": "MOBILE001",
"store_branch_code": "BRANCH001",
"rebate_amount": "10.00",
"amount_paid_in_full": "90.00",
"amount_paid_by_card": "100.00",
"network_authorization_code": "NETAUTH123",
"export_date_time": "2023-10-01T12:34:56",
"authorization_code_aux": "AUTH_AUX123",
"nsu_host_aux": "HOST_AUX123456",
"payment_method_cd": "PM001",
"subtype_payment_cd": "STP001",
"brand_payment_cd": "BP001",
"psp": "PSP001",
"tid": "TID123456",
"payment_value1": "50.00",
"payment_method1": "CREDIT",
"payment_value2": "30.00",
"payment_method2": "DEBIT",
"payment_value3": "20.00",
"payment_method3": "CASH",
"payment_value4": "0.00",
"payment_method4": "NONE",
"doc_cancel": "DOC_CANCEL123"
}
]
}

Field Definitions:

  • status (integer): The HTTP status of the response.
  • timestamp (string): The response timestamp.
  • page (integer): The current page number.
  • items_per_page (integer): The page size.
  • transactions (array de Transaction): The list of transactions.

Example of reversal response#

Description: This object represents the response of a list of transactions.

{
"status": 200,
"timestamp": "18148517815",
"page": "1",
"items_per_page": "100",
"transactions": [
{
"reversal": {
"cod_sit": 5,
"transaction_date": "20231001",
"nsu_sitef": "123456",
"sitef_store_code": "00000001",
"trunk_store_code": "00000001",
"transaction_time": "123456",
"transaction_value": "10000",
"transaction_type": "SALE",
"response_code": "00",
"transaction_status_code": "APPROVED",
"authorization_code": "AUTH123",
"cupom_fiscal": "CF123456",
"card_type": "VISA",
"transaction_info": "Additional info",
"document": "DOC123456",
"installments_number": "1",
"pos_number": "POS001",
"nsu_host": "HOST123456",
"nsu_host_original": "HOST654321",
"input_mode": "CHIP",
"establishment_code": "EST001",
"cnpj": "12345678000195",
"network_description": "Network description",
"client_code": "CLIENT001",
"denied_by": "None",
"fiscal_date": "20231001",
"fiscal_time": "123456",
"codcli": "CODCLI001",
"mobile_operator_code": "MOBILE001",
"store_branch_code": "BRANCH001",
"rebate_amount": "1000",
"amount_paid_in_full": "9000",
"amount_paid_by_card": "10000",
"network_authorization_code": "NETAUTH123",
"export_date_time": "20231001T123400",
"authorization_code_aux": "AUTH_AUX123",
"nsu_host_aux": "HOST_AUX123456",
"payment_method_cd": "PM001",
"subtype_payment_cd": "STP001",
"brand_payment_cd": "BP001",
"psp": "PSP001",
"tid": "TID123456",
"payment_value1": "5000",
"payment_method1": "CREDIT",
"payment_value2": "3000",
"payment_method2": "DEBIT",
"payment_value3": "2000",
"payment_method3": "CASH",
"payment_value4": "000",
"payment_method4": "NONE",
"doc_cancel": "DOC_CANCEL123"
},
"reversed": {
"cod_sit": 5,
"transaction_date": "20231001",
"nsu_sitef": "123457",
"sitef_store_code": "00000001",
"trunk_store_code": "00000001",
"transaction_time": "123456",
"transaction_value": "10000",
"transaction_type": "SALE",
"response_code": "00",
"transaction_status_code": "APPROVED",
"authorization_code": "AUTH123",
"cupom_fiscal": "CF123456",
"card_type": "VISA",
"transaction_info": "Additional info",
"document": "DOC123456",
"installments_number": "1",
"pos_number": "POS001",
"nsu_host": "HOST123456",
"nsu_host_original": "HOST654321",
"input_mode": "CHIP",
"establishment_code": "EST001",
"cnpj": "12345678000195",
"network_description": "Network description",
"client_code": "CLIENT001",
"denied_by": "None",
"fiscal_date": "20231001",
"fiscal_time": "123456",
"codcli": "CODCLI001",
"mobile_operator_code": "MOBILE001",
"store_branch_code": "BRANCH001",
"rebate_amount": "10.00",
"amount_paid_in_full": "9000",
"amount_paid_by_card": "10000",
"network_authorization_code": "NETAUTH123",
"export_date_time": "20231001123456",
"authorization_code_aux": "AUTH_AUX123",
"nsu_host_aux": "HOST_AUX123456",
"payment_method_cd": "PM001",
"subtype_payment_cd": "STP001",
"brand_payment_cd": "BP001",
"psp": "PSP001",
"tid": "TID123456",
"payment_value1": "5000",
"payment_method1": "CREDIT",
"payment_value2": "3000",
"payment_method2": "DEBIT",
"payment_value3": "2000",
"payment_method3": "CASH",
"payment_value4": "000",
"payment_method4": "NONE",
"doc_cancel": "DOC_CANCEL123"
}
}
]
}

Field Definitions:

  • status (integer): The HTTP status of the response.
  • timestamp (string): The response timestamp.
  • page (integer): The current page number.
  • items_per_page (integer): The page size.
  • transactions (array of Reversal): The list of reversed transactions.

Definition of Transaction and Reversal objects:

  1. Transaction object:
  • cod_sit (long): The transaction status code.
  • transaction_date (string): The transaction date.
  • nsu_sitef (string): The unique sequential number generated by Sitef.
  • sitef_store_code (string): The store code in Sitef.
  • trunk_store_code (string): The trunk store code.
  • transaction_time (string): The transaction time.
  • transaction_value (string): The transaction amount.
  • transaction_type (string): The transaction type.
  • response_code (string): The transaction response code.
  • transaction_status_code (TransactionStatusCode): The transaction status code.
  • authorization_code (string): The transaction authorization code.
  • cupom_fiscal (string): The fiscal coupon.
  • card_type (string): The type of card used in the transaction.
  • transaction_info (string): Additional information about the transaction.
  • document (string): The document associated with the transaction.
  • installments_number (string): The number of installments in the transaction.
  • pos_number (string): The POS number.
  • nsu_host (string): The host NSU.
  • nsu_host_original (string): The original host NSU.
  • input_mode (string): The transaction input mode.
  • establishment_code (string): The establishment code.
  • cnpj (string): The establishment CNPJ.
  • network_description (string): The network description.
  • client_code (string): The client code.
  • denied_by (string): The entity that denied the transaction.
  • fiscal_date (string): The transaction fiscal date.
  • fiscal_time (string): The transaction fiscal time.
  • codcli (string): The client code.
  • mobile_operator_code (string): The mobile operator code.
  • store_branch_code (string): The store branch code.
  • rebate_amount (string): The rebate amount.
  • amount_paid_in_full (string): The amount paid in full.
  • amount_paid_by_card (string): The amount paid by card.
  • network_authorization_code (string): The network authorization code.
  • export_date_time (string): The export date and time.
  • authorization_code_aux (string): The auxiliary authorization code.
  • nsu_host_aux (string): The auxiliary host NSU.
  • payment_method_cd (string): The payment method code.
  • subtype_payment_cd (string): The payment subtype code.
  • brand_payment_cd (string): The payment brand code.
  • psp (string): The PSP.
  • tid (string): The TID.
  • payment_value1 (string): The first payment amount.
  • payment_method1 (string): The first payment method.
  • payment_value2 (string): The second payment amount.
  • payment_method2 (string): The second payment method.
  • payment_value3 (string): The third payment amount.
  • payment_method3 (string): The third payment method.
  • payment_value4 (string): The fourth payment amount.
  • payment_method4 (string): The fourth payment method.
  • doc_cancel (string): The document cancelation.

Error response example:#

Description: This object represents an error response.

{
"timestamp": "18148517815",
"status": 400,
"message": "Invalid request parameters"
}

Field Definitions:

  • timestamp (string): O timestamp do erro.
  • status (integer): O status HTTP do erro.
  • message (string): A mensagem descrevendo o erro.