Pagamento de conta não identificada

É a transferência de fundos de um cartão para uma conta, com propósito de pagamento de um boleto, dentro da carteira, cujo cedente não foi informado pela carteira. Por exemplo, pagar um boleto com um cartão da bandeira (seja crédito ou débito) usando a carteira digital e o boleto não possui identificação.

ℹ️

CNPJs alfanuméricos serão implementados pela Receita Federal em julho de 2026

Essa mudança afeta apenas novas inscrições, não havendo mudanças em CNPJs existentes.

O CNPJ alfanumérico já está sendo suportado pela Cielo, sem mudanças na sua integração.

Recomendamos verificar a necessidade de possíveis ajustes nos sistemas próprios de checkout de sua loja.

Confira a seguir um exemplo da requisição de SDWO do tipo pagamento de conta não identificada, com envio do parâmetro IsCustomerBillPaymentService = true:

Requisição

Ambiente

Método

Endpoint

Sandbox

https://apisandbox.braspag.com.br/v2/sales/

Produção

https://api.braspag.com.br/v2/sales/

{
    "MerchantOrderId": "2012345678",
    "Customer": {
        "Name": "Aline de Souza",
        "Identity": "12345678900",
        "IdentityType": "CPF"
    },
    "Payment": {
  			"Provider":"Cielo30",    
				"Type": "CreditCard",
        "Amount": 15700,
     		"Installments": 1,
				"Capture":true,
        "IsCustomerBillPaymentService": true,
        "SoftDescriptor": "CARTEIRA*NOMELOJA",
        "CreditCard": {
            "CardNumber": "4532110000001234",
            "Holder": "Aline de Souza",
            "Brand": "Visa",
            "SecurityCode": "333",
            "ExpirationDate": "12/2035"
        },
        "Wallet": {
            "PlatformOperator": "ABC",
            "AdditionalData": {
                "Mcc": "6540"
            }
        }
    }
}

Parâmetros no cabeçalho (header)


Parâmetros no corpo (body)

Confira a requisição padrão de cartão de crédito ou débito para verificar os demais campos opcionais. A tabela abaixo apresenta os parâmetros exclusivos para transação de SDWO do tipo pagamento de conta não identificada.

Parâmetro

Descrição

Tipo

Tamanho

Obrigatório?

MerchantOrderId

Identificação do pedido. Poderá ser usada para cancelar ou consultar a transação no futuro.
Atenção: Os caracteres permitidos são apenas a-z, A-Z, 0-9. Não são permitidos caracteres especiais e espaços em branco.

string

50

Sim

Customer.Name

Nome do comprador.
Atenção: Os caracteres permitidos são apenas a-z, A-Z. Não são permitidos caracteres especiais e números.

string

255

Sim

Customer.Identity

Número do CPF ou CNPJ do comprador.
Permite envio de CNPJs alfanuméricos.

string

14

Sim, se o portador for pessoa jurídica (CNPJ).

Customer.IdentityType

Tipo de documento de identificação do comprador (CPF/CNPJ).

texto

255

Sim, se o portador for pessoa jurídica (CNPJ).

Payment.Provider

Nome do provedor

texto

15

Sim

Payment.Type

Tipo do meio de pagamento. Valor padrão: CreditCard.

string


Sim

Payment.Amount

Valor do pedido (enviado em centavos).

integer

15

Sim

Payment.Installments

Número de parcelas. Para transações parceladas, o número de parcelas será sempre maior que 1.

integer

2

Sim

Payment.Capture

Booleano que identifica que a autorização deve ser com captura automática (“true”) ou captura posterior (“false”).

Booleano


Não (Default false)

IsCustomerBillPaymentService

Indica que a transferência tem como finalidade o pagamento de uma conta

booleano


Sim

SoftDescriptor

Texto que será impresso na fatura bancária do portador. Não permite caracteres especiais. Necessário preencher no formato Nome da carteira*nome do lojista.

texto

13

Sim

Payment.CreditCard.CardNumber

Número do cartão do comprador.

string

19

Sim

Payment.CreditCard.Holder

Nome do comprador impresso no cartão. Não aceita caracteres especiais ou acentuação.

string

25

Sim

Payment.CreditCard.Brand

Bandeira do cartão. Valores possíveis: Visa / Master / Amex / Elo / Aura / JCB / Diners / Discover.

string

10

Sim

Payment.CreditCard.SecurityCode

Código de segurança impresso no verso do cartão.

string

4

Sim

Payment.CreditCard.ExpirationDate

Data de validade impressa no cartão. Exemplo: MM/AAAA.

string

7

Sim

Payment.Wallet.PlatformOperator

Sigla da carteira que está cadastrada na Cielo como carteira digital (verificar sua sigla com seu gestor comercial).

string (texto)

3

Sim

Payment.Wallet.AdditionalData.Mcc

MCC da carteira digital para transações de pagamento de conta não identificada, conforme a bandeira do cartão. Consulte a Tabela de MCCs para SDWO de arranjo de transferência de fundos.

string (numérico)

4

Sim