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": "4101ad7b-caf7-4065-9fbc-74461715bff8",
"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": ""
},
"notifyOnPayout": true
}
'{
"id": "1585791a-b3e1-4003-9b5c-69ce57b4e8f9",
"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": "e46427e1-2516-49c1-bc7e-83a007fe1e83",
"clientid": "567265cb-fa7f-419f-9c1c-8e878dd2faf7",
"metadata": null,
"owner": {
"id": "c30cfb43-a748-4822-9449-57563d2a1de5",
"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": "55cc95c1-9c63-4755-a836-d9db74c8fd72",
"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": "116d80a5-b204-4861-84c6-2189ee0ac6c7",
"updatedAt": "2023-07-11T23:02:51.588Z",
"createdAt": "2023-07-11T23:02:51.588Z",
"type": "cpf",
"number": "36243319067"
}
},
"business": {
"id": "fb950b1a-bfa2-40e1-8446-18d2dace84d5",
"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": "4f58d047-3f3b-49a8-843e-496a8d7f6135",
"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": "319894f0-1cac-4675-8857-54c0310fedc4",
"updatedAt": "2023-07-11T23:02:51.578Z",
"createdAt": "2023-07-11T23:02:51.578Z",
"type": "cnpj",
"number": "94938591000196"
}
},
"bankAccount": {
"id": "4afa0d0b-466b-4ec7-a772-60559ec489c0",
"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": "5dc4c08d-66b7-490c-b005-dfc0fb79a12f",
"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",
"notifyOnPayout": true
}Sellers
Criação de um novo recebedor
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": "4101ad7b-caf7-4065-9fbc-74461715bff8",
"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": ""
},
"notifyOnPayout": true
}
'{
"id": "1585791a-b3e1-4003-9b5c-69ce57b4e8f9",
"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": "e46427e1-2516-49c1-bc7e-83a007fe1e83",
"clientid": "567265cb-fa7f-419f-9c1c-8e878dd2faf7",
"metadata": null,
"owner": {
"id": "c30cfb43-a748-4822-9449-57563d2a1de5",
"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": "55cc95c1-9c63-4755-a836-d9db74c8fd72",
"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": "116d80a5-b204-4861-84c6-2189ee0ac6c7",
"updatedAt": "2023-07-11T23:02:51.588Z",
"createdAt": "2023-07-11T23:02:51.588Z",
"type": "cpf",
"number": "36243319067"
}
},
"business": {
"id": "fb950b1a-bfa2-40e1-8446-18d2dace84d5",
"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": "4f58d047-3f3b-49a8-843e-496a8d7f6135",
"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": "319894f0-1cac-4675-8857-54c0310fedc4",
"updatedAt": "2023-07-11T23:02:51.578Z",
"createdAt": "2023-07-11T23:02:51.578Z",
"type": "cnpj",
"number": "94938591000196"
}
},
"bankAccount": {
"id": "4afa0d0b-466b-4ec7-a772-60559ec489c0",
"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": "5dc4c08d-66b7-490c-b005-dfc0fb79a12f",
"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",
"notifyOnPayout": true
}Body
application/json
Identificação do merchant id a ser utilizado
Código de segmento do lojista no adquirente, solicite ao seu provedor caso não saiba qual o seu Merchant Category Code.
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Acordo de taxas para cadastro de seller no provedor Braspag. O envio desse nó é opcional durante a criação do recebedor.
Show child attributes
Show child attributes
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:
["74739f85-1bfa-40ae-a003-1c464c8e3c94"]
Identificador do Plano de Venda na Zoop
Example:
"1234567"
Identificador do plano de venda a ser vinculado ao recebedor (ver Listar planos de venda). Quando omitido, o seller usa o plano padrão (isDefault: true) do cliente. Campo distinto de salesPlanId.
Metadados adicionais do recebedor
Show child attributes
Show child attributes
Indica se o recebedor paga a taxa de processamento no split
Indica se o recebedor é responsável por chargeback no split
Percentual MDR para split (Braspag)
Required range:
0 <= x <= 100Taxa fixa em centavos para split (Braspag)
Required range:
x >= 0Saldo negativo mínimo permitido
Prazo máximo de reembolso em dias
Cria o recebedor de forma assíncrona no provedor
Define se o recebedor deve ser notificado quando ocorre um repasse. Quando o campo é omitido, o recebedor é criado com true.
Response
Created
Identificador do seller
Show child attributes
Show child attributes
Identificador do merchant
Identificador do cliente
Campos adicionais da transação enviados na criação da mesma
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Código de segmento do lojista no adquirente
Status do seller
Available options:
active, partial, inactive, pending, blocked Indica se o recebedor é notificado quando ocorre um repasse.
Identificador do plano de venda vinculado ao recebedor (ver Listar planos de venda). Vem null quando o recebedor não tem vínculo próprio e é liquidado pelo plano padrão do cliente. Campo distinto de salesPlanId.
Was this page helpful?