Get Merchant Details

Get Merchant Details

API: GetMerchantDetails

This API is responsible for retrieving the details of a specific merchant within the Closed Loop system.

The query is performed using the merchant's unique identifier (MerchantIdentifier), returning all registration data, address information, contact details, and the financial configuration associated with the merchant.


Request Structure

{
  "Method": "GetMerchantDetails",
  "BusinessUnitId": 30472,
  "PartnerId": 10409,
  "MerchantIdentifier": "MER086c63fa-ccf8-4995-b988-439c347aa9c4MER"
}

Request Parameters

ParameterTypeDescriptionExampleMandatory
MethodstringMethod name"GetMerchantDetails"Yes
PartnerIdbigintInformation provided by FitBank10409Yes
BusinessUnitIdbigintInformation provided by FitBank30472Yes
MerchantIdentifiervarcharUnique identifier of the merchant"MER086c63fa-ccf8-4995-b988-439c347aa9c4MER"Yes

Response Structure

{
  "Success": "true",
  "Message": "Merchant details retrieved successfully",
  "Merchant": {
    "MerchantIdentifier": "MER086c63fa-ccf8-4995-b988-439c347aa9c4MER",
    "MerchantName": "Bakery",
    "LegalName": "Bakery LTDA",
    "TaxNumber": "33.762.255/0001-40",
    "BusinessUnitId": 10409,
    "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"
    },
    "CreatedAt": "2024-03-01T10:00:00Z",
    "UpdatedAt": "2024-03-10T15:30:00Z",
    "DailyLimit": {
      "TotalAmount": 5000.00
    }
  }
}

 

Response Fields

TypeFieldDescription
booleanSuccessIndicates whether the request was successfully processed.
stringMessageAPI response message describing the result of the operation.
objectMerchantObject containing the merchant's complete information.

Merchant Object

FieldTypeDescription
MerchantIdentifiervarcharUnique identifier of the merchant.
MerchantNamestringMerchant's trade name.
LegalNamestringMerchant's legal company name.
TaxNumbervarcharMerchant's fiscal identifier.
BusinessUnitIdbigintBusiness unit associated with the merchant.
PhonevarcharMerchant's phone number.
EmailstringMerchant's contact email.
ConstitutionDatedatetimeCompany establishment date.
CompanyAddressobjectMerchant's address information.
CreatedAtdatetimeDate when the merchant was created in the system.
UpdatedAtdatetimeDate of the last update to the merchant's data.
DailyLimitobjectMerchant's financial configuration.
DailyLimit.TotalAmountdecimalBase limit configured for the merchant in the system.