Skip to main content
POST
/
v1
/
sellers
curl --request POST \
  --url https://api.malga.io/v1/sellers \
  --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

Body

application/json
​
merchantId
string
required

identificação do merchant id a ser utilizado

​
mcc
number
required

código de segmento do lojista no adquirente, solicite ao seu provedor caso não saiba qual o seu Merchant Category Code.

​
owner
object
required
​
bankAccount
object
required
​
business
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.

​
documentIds
string<uuid>[]

IDs dos documentos previamente enviados via POST /v1/sellers/documents. Os documentos serão associados ao seller e enviados ao provedor na criação.

Example:
["a1b2c3d4-e5f6-7890-abcd-ef1234567890"]
​
salesPlanId
string

Identificador do Plano de Venda na Zoop

Example:

"1234567"

​
metadata
object[]

Metadados adicionais do recebedor

​
processingFee
boolean

Indica se o recebedor paga a taxa de processamento no split

​
liable
boolean

Indica se o recebedor é responsável por chargeback no split

​
fareMdr
number

Percentual MDR para split (Braspag)

Required range: 0 <= x <= 100
​
fareFee
number

Taxa fixa em centavos para split (Braspag)

Required range: x >= 0
​
minNegativeBalance
number

Saldo negativo mínimo permitido

​
maxRefundDays
number

Prazo máximo de reembolso em dias

​
createAsync
boolean

Cria o recebedor de forma assíncrona no provedor

Response

Created

​
id
string

Identificador do seller

​
providers
object[]
​
merchantId
string

Identificador do merchant

​
clientId
string

Identificador 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

​
status
enum<string>

Status do seller

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