Update a Merchant

UpdateMerchantClosedLoopInfo

Updates the registration and financial information of a merchant within the Closed Loop system.

This method allows updating the merchant's business information, address details, and financial parameters associated with the store.

Each merchant has an individual POS account linked to the associated company, enabling tracking, reconciliation, and monitoring of transactions performed by that store.


New Financial Parameters

Starting from this API version, new parameters have been added related to balance control and the daily limit available for the merchant.

DailyLimit

Object responsible for defining the financial limits available for the merchant.

FieldTypeDescription
TotalAmountdecimalTotal base amount available for the merchant within the system.

Daily Limit Usage Rules

  • The additional limit can be requested only once per day.
  • After a request is made, a new request can only be submitted on the following day.
  • The requested value can represent a maximum increase of 25% over the merchant's base balance.
  • The base balance is defined at the time the merchant is created.

Request Structure

{
  "Method": "UpdateMerchantClosedLoopInfo",
  "BusinessUnitId": 30472,
  "PartnerId": 10409,
  "MerchantIdentifier": "MER086c63fa-ccf8-4995-b988-439c347aa9c4MER",
  "MerchantName": "Bakery",
  "LegalName": "Bakery ltda",
  "TaxNumber": "33.762.255/0001-40",
  "Sector": "food",
  "Phone": 302123456789,
  "Email": "[email protected]",
  "ConstitutionDate": "2024-04-17T14:06:04.837Z",
  "CompanyAddress": {
    "Line": "Street José Morais",
    "Number": "478",
    "Complement": "House",
    "Reference": "Near restaurant",
    "Neighborhood": "Aldeota",
    "City": "Crateus",
    "State": "CE",
    "ZipCode": "60115221",
    "Country": "BR"
  },
  "DailyLimit": {
    "TotalAmount": 5000.55
  }
}

 

Parameter Descriptions:

ParameterDescriptionTypeExampleMandatory
MethodMethod namestring"UpdateMerchantClosedLoopInfo"Yes
PartnerInformation provided by FitBankbigint"847561"Yes
BusinessUnitIdInformation provided by FitBankint"234334"Yes
ContractIdentifierContract identifiervarchar"CON965569f9-5c93-4335-b09e-29efe32ba292CON"Yes
MerchantNameMerchant namestring"Super 24 - Montufar"Yes
LegalNameLegal name of the companystring"Prones y Pagamentos"Yes
TaxNumberFiscal identifiervarchar"3480082520113"Yes
SectorEstablishment sectorvarchar"Food"Yes
ConstitutionDateDate of company's establishment (e.g., "2013-05-13")date"24/09/2023 14:30:00"Yes
MerchantIdentifierEstablishment identifiervarchar"MER0551a52e-b0e7-4c58-8b26-0a3016f458caMER"Yes
AccountKeyCommercial establishment's key accountvarchar"963497-209911-9590853-5"No
PhoneEstablishment's phone numbervarchar"+50223629963"Yes
EmailEstablishment's email addressvarchar"[email protected]"Yes
PostalCodePostal Code of the Establishmentvarchar"01009"Yes
StreetEstablishment's streetvarchar"CALLE 12"Yes
NumberEstablishment's numbervarchar"2-21"Yes
ComplementAddress complement of the establishmentvarchar"Calle Montufar"Yes
NeighborhoodNeighborhood/Zone of ​​the Establishmentvarchar"ZONA 9"Yes
CityCity of the Establishmentdatetime"Ciudad de Guatemala"Yes
StateState/Department of the Establishmentvarchar"Departamento de Guatemala"Yes
ReferenceReference point near the establishmentvarchar"Paleta Montufar"Yes
CountryCodeCountry Code (e.g. GT)varcharGTYes
DailyLimitDaily limit that can be requested by the merchant (once/day)decimalQ25.00Yes
TotalAmountBase balance amount available for the merchantdecimalQ5.000.00Yes