Skip to main content

Create Partner

To create a partner, you must use this route.

Important

In order to comply with the guidelines set forth in Central Bank Circular 3.978/20 regarding procedures to be adopted for money laundering prevention and terrorism financing, it is essential to send all the data set forth in this documentation for seller registration. This guideline came into effect in February 2024.

Direct Settlement - Production Environment

The SubSellers creation flow in Marlim is available in production, allowing complete partner registration with all necessary data to comply with Central Bank guidelines. However, direct settlement to SubSellers' bank accounts is still under development and not available at the moment. To get information about the release schedule for this functionality, contact the Marlim team through our support channels.

POSTv3/sub_sellers

Request Body Params​

AttributeTypeDescription
business_namestringCompany Legal Name.
social_namestringCompany Trade Name.
emailstringCompany email.
documentstringCompany CNPJ.
foundation_datestringCompany foundation date in YYYY-MM-DD format.
phone_numberobjectCompany Phone object.
phone_number[ddd]stringCompany phone area code.
phone_number[number]stringCompany phone number.
main_addressobjectCompany main address object.
main_address[zip_code]stringCompany address ZIP code.
main_address[state]stringCompany address state.
main_address[city]stringCompany address city.
main_address[neighborhood]stringCompany address neighborhood.
main_address[street]stringCompany address street.
main_address[number]stringCompany address number.
main_address[complementary]stringCompany address complement.
managing_partnerobjectCompany managing partner object.
managing_partner[name]stringManaging partner name.
managing_partner[document]stringManaging partner CPF.
managing_partner[birthdate]stringManaging partner birth date in DD/MM/YYYY format.
managing_partner[phone_number]objectManaging partner phone object.
managing_partner[phone_number][ddd]stringManaging partner phone area code.
managing_partner[phone_number][number]stringManaging partner phone number.
managing_partner[address]objectManaging partner address object.
managing_partner[address][zip_code]stringManaging partner address ZIP code.
managing_partner[address][state]stringManaging partner address state.
managing_partner[address][city]stringManaging partner address city.
managing_partner[address][neighborhood]stringManaging partner address neighborhood.
managing_partner[address][street]stringManaging partner address street.
managing_partner[address][number]stringManaging partner address number.
managing_partner[address][complementary]stringManaging partner address complement.
bank_accountobjectCompany bank account object.
bank_account[bank]stringBank code.
bank_account[agency]stringAgency number.
bank_account[agency_digit]stringAgency digit.
bank_account[account_number]stringAccount number.
bank_account[account_digit]stringAccount digit.
bank_account[type]stringAccount type. Accepted values: checking or savings.
bank_account[pix]objectPix key data object.
bank_account[pix][type]stringPix key type.
Accepted values: cpf, cnpj, email or phone.
bank_account[pix][key]stringPix key value. Must be informed according to the Pix key type.
Request Body Example
{
  "business_name": "Empresa Jedi LTDA",
  "social_name": "Empresa Jedi",
  "email": "contato@empresajedi.com.br",
  "document": "123456789",
  "foundation_date": "2020-01-01",
  "phone_number": {
    "ddd": "11",
    "number": "999999999"
  },
  "main_address": {
    "zip_code": "01234567",
    "state": "SP",
    "city": "São Paulo",
    "neighborhood": "Centro",
    "street": "Rua Jedi",
    "number": "123",
    "complementary": "Sala 45"
  },
  "managing_partner": {
    "name": "Luke Skywalker",
    "document": "12345678900",
    "birthdate": "01/01/1980",
    "phone_number": {
      "ddd": "11",
      "number": "988888888"
    },
    "address": {
      "zip_code": "01234567",
      "state": "SP",
      "city": "São Paulo",
      "neighborhood": "Centro",
      "street": "Rua Jedi",
      "number": "123",
      "complementary": "Apto 45"
    }
  },
  "bank_account": {
    "bank": "001",
    "agency": "1234",
    "agency_digit": "5",
    "account_number": "123456",
    "account_digit": "7",
    "type": "checking",
    "pix": {
      "type": "email",
      "key": "contato@empresajedi.com.br"
    }
  }
}

Response Object​

AttributeTypeDescription
statusstringPartner status. Default value: pending.
sub_seller_idstringPartner ID.
namestringPartner name.
date_createddateTimePartner creation date in ISODateTime format.
date_updateddateTimePartner update date in ISODateTime format.
business_namestringPartner Legal Name.
social_namestringPartner Trade Name.
emailstringPartner email.
documentstringPartner CNPJ.
Response Example
{
  "status": "pending",
  "sub_seller_id": "sub_k4m6Rw5rlQszEY7fiuRe",
  "name": "Empresa Jedi",
  "date_created": "2025-07-07T19:26:42.779Z",
  "date_updated": "2025-07-07T20:26:42.779Z",
  "business_name": "Empresa Jedi LTDA",
  "social_name": "Empresa Jedi",
  "email": "contato@empresajedi.com.br",
  "document": "12345678000190"
}

Error Object​

AttributeTypeDescription
api_referencestringURL for documentation.
errorsarrayArray with all errors found when processing the request.
errors[][type]stringType of error that occurred.
errors[][message]stringDetailed error message.
Error Example
{
  "api_reference": "https://docs.api.marlim.co/sub_sellers/create",
  "errors": [
    {
      "type": "validation",
      "message": "The CNPJ provided is invalid."
    }
  ]
}
tip

The value returned in sub_seller_id is the ID that will be used to create transactions in Split Payment format with multiple partners and also to perform Pix transfer.

Examples​

WARNING

The values used in the examples below are for illustration purposes only and should not be used to make requests to Marlim APIs. In development and testing environments, use data closer to a real transaction (card and customer data). If you use fictitious values, the Antifraud may not work as expected.

Request
curl -X POST "https://api.marlim.co/v3/sub_sellers" \
-H "Content-Type: application/json" \
-H "api_key: api_key_value" \
-d '{
  "business_name": "Empresa Jedi LTDA",
  "social_name": "Empresa Jedi",
  "email": "contato@empresajedi.com.br",
  "document": "12345678000190",
  "foundation_date": "2020-01-01",
  "phone_number": {
    "ddd": "11",
    "number": "999999999"
  },
  "main_address": {
    "zip_code": "01234567",
    "state": "SP",
    "city": "São Paulo",
    "neighborhood": "Centro",
    "street": "Rua Jedi",
    "number": "123",
    "complementary": "Sala 45"
  },
  "managing_partner": {
    "name": "Luke Skywalker",
    "document": "12345678900",
    "birthdate": "01/01/1980",
    "phone_number": {
      "ddd": "11",
      "number": "988888888"
    },
    "address": {
      "zip_code": "01234567",
      "state": "SP",
      "city": "São Paulo",
      "neighborhood": "Centro",
      "street": "Rua Jedi",
      "number": "123",
      "complementary": "Apto 45"
    }
  },
  "bank_account": {
    "bank": "001",
    "agency": "1234",
    "agency_digit": "5",
    "account_number": "123456",
    "account_digit": "7",
    "type": "checking",
    "pix": {
      "type": "email",
      "key": "contato@empresajedi.com.br"
    }
  }
}'
Response200
{
  "status": "pending",
  "sub_seller_id": "sub_k4m6Rw5rlQszEY7fiuRe",
  "name": "Empresa Jedi",
  "date_created": "2025-07-29T11:38:57.688Z",
  "date_updated": "2025-07-29T11:38:57.688Z",
  "business_name": "Empresa Jedi LTDA",
  "social_name": "Empresa Jedi",
  "email": "contato@empresajedi.com.br",
  "document": "12345678000190"
}