Atualizar subconta

❗️
IMPORTANTE

O objeto MerchantSplit substitui a configuração inteira da subconta. Os meios de pagamento e serviços que não estiverem no array são removidos, portanto informe sempre a configuração completa, mesmo que a alteração seja apenas em um meio de pagamento/serviço em específico.

Se você não informar o objeto MerchantSplit, a configuração de taxas atual da subconta é mantida exatamente como está. Use assim quando a chamada for apenas para atualizar dados cadastrais ou bancários.

ℹ️
Antes de configurar as taxas da subconta, recomendamos fortemente que você leia:

Sobretaxa: documentação completa de configuração de sobretaxa.

Ela traz os detalhes de quem paga a taxa da Safe2Pay e recebe a NFS-e, os tipos de taxa aceitos em cada meio de pagamento, as regras dos serviços de Repasse, Nota Fiscal de Serviço, SMS e Antifraude, os casos em que não é possível cobrar sobretaxa da subconta e o que é recusado na validação.
Entender esses pontos evita erros comuns na integração e garante que a configuração de taxas da subconta seja gravada exatamente como você espera.

{
    "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
            "IsSubaccountTaxPayer": false,
            "Taxes": [
                {
                    "TaxTypeName": "2",
                    "Tax": "0"
                }
            ]
        },
        {
            "PaymentMethodCode": "26", //Repasse - a subconta paga a taxa da Safe2Pay e mais R$ 1,00 de sobretaxa
            "IsSubaccountTaxPayer": true,
            "Taxes": [
                {
                    "TaxTypeName": "2",
                    "Tax": "1.00"
                }
            ]
        }
    ]
}

{
    //A subconta paga a taxa de repasse da Safe2Pay e o marketplace não cobra sobretaxa.
    //Esta é a mesma configuração aplicada automaticamente quando o MerchantSplit é informado sem o PaymentMethodCode 26.
    "MerchantSplit": [
        {
            "PaymentMethodCode": "1", //Boleto
            "IsSubaccountTaxPayer": false,
            "Taxes": [
                {
                    "TaxTypeName": "2",
                    "Tax": "2.20"
                }
            ]
        },
        {
            "PaymentMethodCode": "26", //Repasse
            "IsSubaccountTaxPayer": true,
            "Taxes": [
                {
                    "TaxTypeName": "2",
                    "Tax": "0"
                }
            ]
        }
    ]
}

{
    //O marketplace assume a taxa de repasse da Safe2Pay e recebe a NFS-e.
    //O valor informado já inclui a taxa da Safe2Pay: se ela for de R$ 2,50, a sobretaxa é de R$ 1,50.
    "MerchantSplit": [
        {
            "PaymentMethodCode": "1", //Boleto
            "IsSubaccountTaxPayer": false,
            "Taxes": [
                {
                    "TaxTypeName": "2",
                    "Tax": "2.20"
                }
            ]
        },
        {
            "PaymentMethodCode": "26", //Repasse
            "IsSubaccountTaxPayer": false,
            "Taxes": [
                {
                    "TaxTypeName": "2",
                    "Tax": "4.00"
                }
            ]
        }
    ]
}

{
    //Sem o objeto MerchantSplit, a configuração de taxas da subconta é mantida exatamente como está.
    //Use assim para atualizar apenas dados cadastrais ou bancários.
    "ResponsiblePhone": "51999999999",
    "Email": "[email protected]",
    "BankData": {
        "Bank": {
            "Code": "260"
        },
        "AccountType": {
            "Code": "CC"
        },
        "BankAgency": "0001",
        "BankAgencyDigit": "",
        "BankAccount": "5780057",
        "BankAccountDigit": "5"
    }
}

200