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": "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
Atualização de recebedor pelo ID
Atualização parcial do recebedor. Envie apenas os campos que deseja alterar; campos omitidos permanecem inalterados.
Atenção (Provedor Pagar.me V5):
Ao atualizar a conta bancária (bankAccount) de um seller, o IP do servidor que realiza a requisição deve estar previamente cadastrado na Allow List (Lista de Permissões) no dashboard da Pagar.me.
Saiba como configurar a Allow List aqui.
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": "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
}Path Parameters
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.
Identificação do merchant
Código de segmento do lojista no adquirente
Show child attributes
Show child attributes
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
Status do recebedor
Available options:
active, partial, inactive, pending, blocked Motivo do status
Tipo do motivo de status
Available options:
other, funds IDs de documentos a associar ao recebedor
Required range:
0 <= x <= 100Required range:
x >= 0Identificador do plano de venda a ser vinculado ao recebedor (ver Listar planos de venda). Quando omitido, o vínculo atual é mantido; para remover o vínculo e voltar ao plano padrão do cliente, use Desvincular plano de venda de um recebedor. Campo distinto de salesPlanId.
Define se o recebedor deve ser notificado quando ocorre um repasse. Quando o campo é omitido, o valor atual do recebedor é mantido.
Response
Updated
Identificação do seller
Show child attributes
Show child attributes
Identificação do merchant
Identificação 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
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?