Skip to main content
PATCH
/
v1
/
sellers
/
{id}
curl --request PATCH \
  --url https://api.malga.io/v1/sellers/{id} \
  --header 'Content-Type: application/json' \
  --header 'X-Api-Key: <api-key>' \
  --header 'X-Client-Id: <api-key>' \
  --data '
{
  "merchantId": "b1612460-0fef-447d-9590-97825cf60cf6",
  "owner": {
    "name": "Seller test",
    "email": "seller@gmail.com",
    "phoneNumber": "21 98889999099",
    "birthdate": "1995-01-27",
    "document": {
      "type": "cpf",
      "number": "36243319067",
      "country": "BR"
    },
    "address": {
      "street": "Av Geraldo Cardoso",
      "streetNumber": "205",
      "complement": "Apto 203",
      "zipCode": "25650011",
      "country": "BR",
      "state": "Rio de Janeiro",
      "city": "Rio de Janeiro",
      "district": "Leblon",
      "referencePoint": "Proximo a praia"
    },
    "businessCategory": "OTHER_SERVICES"
  },
  "business": {
    "name": "Seller business test",
    "corporateReason": "Seller company social reason",
    "phoneNumber": "21 98889999099",
    "email": "seller@gmail.com",
    "website": "https://sellerbusiness.com.br",
    "description": "Seller business",
    "facebook": "facebook Seller business",
    "twitter": "twitter Seller business",
    "openingDate": "1995-01-27",
    "annualRevenue": 2500000,
    "address": {
      "street": "Rua Nova Lua",
      "streetNumber": "30",
      "complement": "sala 100",
      "zipCode": "61000-320",
      "country": "BR",
      "state": "CE",
      "city": "Maracanaú",
      "district": "AB"
    },
    "document": {
      "type": "cnpj",
      "number": "94938591000196",
      "country": "BR"
    }
  },
  "mcc": 4040,
  "bankAccount": {
    "holderName": "Seller Name",
    "holderDocument": "94938591000196",
    "bank": "077",
    "branchNumber": "492",
    "branchCheckDigit": "1",
    "accountNumber": "4929",
    "accountCheckDigit": "12",
    "type": "conta_corrente",
    "pixKey": "1234567890"
  },
  "transferPolicy": {
    "transferDay": "5",
    "transferEnabled": true,
    "transferInterval": "weekly",
    "automaticAnticipationEnabled": false,
    "anticipatableVolumePercentage": "",
    "automaticAnticipationType": "",
    "automaticAnticipationDays": "",
    "automaticAnticipation1025Delay": ""
  }
}
'
{
  "id": "19d05a45-0e92-478e-8366-955231bcf3d6",
  "providers": {
    "providerType": "SANDBOX",
    "externalId": "1966811",
    "externalStatus": "active",
    "externalStatusReason": "ok",
    "status": "pending",
    "createdAt": "2022-12-21T23:10:13.498Z",
    "updatedAt": "2022-12-21T20:10:13.951Z"
  },
  "merchantId": "5616b19e-4d99-4bd3-b415-4990e5cab4f4",
  "clientid": "e234eeb3-483d-4df2-87eb-1e2be5cdaccd",
  "metadata": null,
  "owner": {
    "id": "8231ba21-3758-4bd7-b664-5b5fdeda37a0",
    "updatedAt": "2023-07-11T23:02:51.581Z",
    "createdAt": "2023-07-11T23:02:51.581Z",
    "name": "Seller",
    "email": "seller@email.com",
    "phoneNumber": "85988350264",
    "birthdate": "1995-01-27T02:00:00.000Z",
    "address": {
      "country": "BR",
      "id": "883631f0-fea0-4682-ae1a-f4ac6349e0d9",
      "updatedAt": "2023-07-11T23:02:51.585Z",
      "createdAt": "2023-07-11T23:02:51.585Z",
      "street": "Rua Nova Lua",
      "streetNumber": "30",
      "complement": "casa 4",
      "zipCode": "61000-320",
      "state": "CE",
      "city": "Maracanaú",
      "district": "AB"
    },
    "document": {
      "country": "BR",
      "id": "32543bbe-42c1-4000-9b68-d01a2735708e",
      "updatedAt": "2023-07-11T23:02:51.588Z",
      "createdAt": "2023-07-11T23:02:51.588Z",
      "type": "cpf",
      "number": "36243319067"
    }
  },
  "business": {
    "id": "607bb56a-974a-4d1d-9f56-cda865dfafbd",
    "updatedAt": "2023-07-11T23:02:51.571Z",
    "createdAt": "2023-07-11T23:02:51.571Z",
    "name": "Seller business",
    "corporateReason": "Seller company social reason",
    "phoneNumber": "85988350264",
    "email": "seller@email.com",
    "website": "www.sellerbusiness.com.br",
    "description": "Seller business",
    "facebook": "facebook Seller business",
    "twitter": "twitter Seller business",
    "openingDate": "1995-01-27",
    "address": {
      "country": "BR",
      "id": "b681dd2e-ebdb-4fad-8c8b-e703a17825ce",
      "updatedAt": "2023-07-11T23:02:51.574Z",
      "createdAt": "2023-07-11T23:02:51.574Z",
      "street": "Rua Nova Lua",
      "streetNumber": "30",
      "complement": "sala 100",
      "zipCode": "61000-320",
      "state": "CE",
      "city": "Maracanaú",
      "district": "AB"
    },
    "document": {
      "country": "BR",
      "id": "b9380f2c-a657-4f47-a7da-21f3bf08182c",
      "updatedAt": "2023-07-11T23:02:51.578Z",
      "createdAt": "2023-07-11T23:02:51.578Z",
      "type": "cnpj",
      "number": "94938591000196"
    }
  },
  "bankAccount": {
    "id": "f7ac3221-8f69-4276-b88b-34ddbe5ec24a",
    "updatedAt": "2023-07-11T23:02:51.563Z",
    "createdAt": "2023-07-11T23:02:51.563Z",
    "holderName": "Seller name",
    "holderDocument": "36243319067",
    "bank": "077",
    "ispb": "60746948",
    "branchNumber": "492",
    "branchCheckDigit": "1",
    "accountNumber": "4929",
    "accountCheckDigit": "22",
    "type": "conta_corrente"
  },
  "transferPolicy": {
    "id": "a04bca24-f7d1-4cb5-acce-41f12680e5bf",
    "updatedAt": "2023-07-11T23:02:51.567Z",
    "createdAt": "2023-07-11T23:02:51.567Z",
    "transferDay": "5",
    "transferEnabled": true,
    "transferInterval": "weekly",
    "automaticAnticipationEnabled": false,
    "anticipatableVolumePercentage": "",
    "automaticAnticipationType": "",
    "automaticAnticipationDays": "",
    "automaticAnticipation1025Delay": ""
  },
  "mcc": 4040,
  "status": "active"
}

Authorizations

X-Client-Id
string
header
required
X-Api-Key
string
header
required

Path Parameters

id
string<uuid>
required

Identificador do seller

Body

application/json

Corpo da atualização parcial. Todos os campos são opcionais — envie apenas o que deseja alterar. Campos omitidos não são modificados.

merchantId
string

Identificação do merchant

mcc
number

Código de segmento do lojista no adquirente

metadata
object[]
owner
object
business
object
bankAccount
object
transferPolicy
object
rateAgreements
object[]

Acordo de taxas para cadastro de seller no provedor Braspag. O envio desse nó é opcional durante a criação do recebedor.

status
enum<string>

Status do recebedor

Available options:
active,
partial,
inactive,
pending,
blocked
statusReason
string

Motivo do status

reasonType
enum<string>

Tipo do motivo de status

Available options:
other,
funds
documentIds
string<uuid>[]

IDs de documentos a associar ao recebedor

processingFee
boolean
liable
boolean
fareMdr
number
Required range: 0 <= x <= 100
fareFee
number
Required range: x >= 0
salesPlanId
string
minNegativeBalance
number
maxRefundDays
number
createAsync
boolean

Response

Updated

id
string

identificação do seller

providers
object[]
merchantId
string

identificação do merchant

clientId
string

identificação do cliente

metadata
object

Campos adicionais da transação enviados na criação da mesma

owner
object
business
object
bankAccount
object
transferPolicy
object
mcc
string

código de segmento do lojista no adquirente