post
https://api.safe2pay.com.br/v2/marketplace/add
Serviço responsável por criar uma subconta em seu marketplace.
IMPORTANTE
- O Token de autenticação para integração é retornado apenas no momento da criação da subconta;
- Em caso de perda do Token, é preciso acionar o time de suporte para criação de um novo Token.
- Sempre informe o objeto MerchantSplit e BankData completos, mesmo que a alteração seja apenas em um meio de pagamento/serviço em específico.
Suporte a CNPJ alfanumérico
A Receita Federal iniciará a emissão de CNPJs alfanuméricos a partir de julho de 2026. Essa mudança se aplica exclusivamente a novas inscrições, não havendo alterações nos CNPJs já existentes.
A Safe2Pay estará apta a processar e receber CNPJs alfanuméricos a partir da entrada em vigor dessa mudança, incluindo integrações com adquirentes que suportam esse formato, como a Cielo.
Não serão necessárias alterações na integração da API da Safe2Pay.
Recomendamos, no entanto, que integradores e estabelecimentos revisem seus sistemas próprios (checkout, ERP, antifraude e validações cadastrais) para garantir compatibilidade com o novo padrão, especialmente para:
- Aceitar caracteres alfanuméricos nos campos de CNPJ;
- Evitar validações restritas apenas a números;
- Revisar máscaras e expressões regulares utilizadas na validação do documento.
{
"Name": "TECIDOS FARIA DUARTE",
"CommercialName": "TECIDOS FARIA DUARTE",
"Identity": "74910037000193",
"ResponsibleName": "Responsável",
"ResponsibleIdentity": "862.811.180-81",
"ResponsibleBirthDate": "1985-07-30",
"ResponsiblePhone": "51999999999",
"Email": "[email protected]",
"BankData": {
"Bank": {
"Code": "260"
},
"AccountType": {
"Code": "CC"
},
"BankAgency": "0001",
"BankAgencyDigit": "",
"BankAccount": "5780057",
"BankAccountDigit": "5"
},
"Address": {
"ZipCode": "90670090",
"Street": "Logradouro",
"Number": "123",
"Complement": "Complemento",
"District": "Higienopolis",
"CityName": "Porto Alegre",
"StateInitials": "RS",
"CountryName": "Brasil"
},
"IsPanelRestricted": true, // Liberar acesso ao painel para a subconta, se true bloqueia, se false libera.
"IsTransferCheckingAccountDisabled": false, // Desabilitar o repasse de valores da safe2pay para a conta bancária cadastrada na subconta.
//Split estático e meios de pagamentso liberados para a subconta
"MerchantSplit": [
{
"PaymentMethodCode": "1", //Boleto
"IsSubaccountTaxPayer": false,
"Taxes": [
{
"TaxTypeName": "2",
"Tax": "2.20"
}
]
},
{
"PaymentMethodCode": "2", //Crédito
"IsSubaccountTaxPayer": false,
"Taxes": [
{
"TaxTypeName": "1",
"Tax": "3.30"
}
]
},
{
"PaymentMethodCode": "6", //Pix
"IsSubaccountTaxPayer": false,
"Taxes": [
{
"TaxTypeName": "2",
"Tax": "1.99"
}
]
},
{
"PaymentMethodCode": "15", //Antecipação
"IsSubaccountTaxPayer": false,
"Taxes": [
{
"TaxTypeName": "1",
"Tax": "3.50"
}
]
},
{
"PaymentMethodCode": "16", //Antifraude - Custo de 0,50
"IsEnabled": true
}
]
}{
"MerchantSplit": [
{
"PaymentMethodCode": "1", //Boleto
"IsSubaccountTaxPayer": false,
"Taxes": [
{
"TaxTypeName": "2",
"Tax": "2.20"
}
]
},
{
"PaymentMethodCode": "2", //Crédito
"IsSubaccountTaxPayer": false,
"Taxes": [
{
"TaxTypeName": "1",
"Tax": "3.30"
}
]
},
{
"PaymentMethodCode": "6", //Pix
"IsSubaccountTaxPayer": false,
"Taxes": [
{
"TaxTypeName": "2",
"Tax": "1.99"
}
]
},
{
"PaymentMethodCode": "15", //Antecipação
"IsSubaccountTaxPayer": false,
"Taxes": [
{
"TaxTypeName": "1",
"Tax": "3.50"
}
]
},
{
"PaymentMethodCode": "16", //Antifraude - Custo de 0,50
"IsEnabled": true
}
]
}{
"Name": "SUBCONTA EXEMPLO",
"CommercialName": "SUBCONTA EXEMPLO",
"Identity": "00000000000",
"ResponsibleName": "Responsável Exemplo",
"ResponsibleIdentity": "00000000000",
"ResponsibleBirthDate": "1985-07-30",
"ResponsiblePhone": "550000000000",
"Email": "[email protected]",
"BankData": {
"Bank": {
"Code": "999"
},
"AccountType": {
"Code": "CC"
},
"BankAgency": "0000",
"BankAgencyDigit": "",
"BankAccount": "0000000",
"BankAccountDigit": "0"
},
"Address": {
"ZipCode": "00000000",
"Street": "Rua Exemplo",
"Number": "0",
"Complement": "Complemento Exemplo",
"District": "Bairro Exemplo",
"CityName": "Cidade Exemplo",
"StateInitials": "XX",
"CountryName": "País Exemplo"
},
"IsPanelRestricted": true,
"IsTransferCheckingAccountDisabled": true,
"MerchantPaymentDate": {
"PaymentDay": 20,
"PlanFrequence": {
"Code": 1
}
},
"MerchantSplit": [
{
"PaymentMethodCode": "1",
"IsSubaccountTaxPayer": false,
"Taxes": [
{
"TaxTypeName": "2",
"Tax": "2.20"
}
]
},
{
"PaymentMethodCode": "2",
"IsSubaccountTaxPayer": false,
"Taxes": [
{
"TaxTypeName": "1",
"Tax": "6.00"
}
]
},
{
"PaymentMethodCode": "6",
"IsSubaccountTaxPayer": false,
"Taxes": [
{
"TaxTypeName": "2",
"Tax": "3.60"
}
]
}
]
}