Unidentified boleto

This is the transfer of funds from a card to an account, for the purpose of paying a boleto, within the wallet, where the payee was not informed by the wallet. For example, paying a boleto with a branded card (either credit or debit) using the digital wallet and the boleto does not have identification.

ℹ️
Alphanumeric CNPJs will be implemented by the Brazilian Federal Revenue Service in July 2026
This change applies only to new registrations. There will be no changes to existing CNPJs.
The alphanumeric CNPJ is already supported by Cielo, with no changes required to your integration.
We recommend checking whether adjustments are needed in your merchant’s own checkout systems.

See below for an example of a SDWO request of the type unidentified bill payment, with the parameter IsCustomerBillPaymentService = true:

Request

Ambiente	Método	Endpoint
Sandbox	post	`https://apisandbox.braspag.com.br/v2/sales/`
Produção	post	`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"
            }
        }
    }
}

Header parameters

Property	Description	Type	Size	Required
`MerchantId`	Merchant identifier in Gateway de Pagamento.	Text	36	Yes
`MerchantKey`	Public key for dual authentication in Gateway de Pagamento.	Text	40	Yes
`RequestId`	Request identifier, used when the merchant uses different servers for each GET/POST/PUT.	Text	36	No

post

Body parameters

Check the standard credit or debit card request to verify other optional fields. The table below presents the exclusive parameters for SDWO transactions of the type unidentified bill payment.

Parameter	Description	Type	Size	Required?
`MerchantOrderId`	Order identification. Can be used to cancel or query the transaction in the future. Note: Only characters a-z, A-Z, 0-9 are allowed. Special characters and spaces are not permitted.	string	50	Yes
`Customer.Name`	Buyer's name. Note: Only characters a-z, A-Z are allowed. Special characters and numbers are not permitted.	string	255	Yes
`Customer.Identity`	Buyer's CPF or CNPJ number. Allows submission of alphanumeric CNPJs.	text	14	Yes, if the holder is a legal entity (CNPJ).
`Customer.IdentityType`	Type of buyer's identification document (CPF/CNPJ).	text	255	Yes, if the holder is a legal entity (CNPJ).
`Payment.Provider`	Provider name	text	15	Yes
`Payment.Type`	Type of payment method. Default value: CreditCard.	string		Yes
`Payment.Amount`	Order amount (sent in cents).	integer	15	Yes
`Payment.Installments`	Number of installments. For installment transactions, the number of installments will always be greater than 1.	integer	2	Yes
`Payment.Capture`	Boolean that identifies whether the authorization should be with automatic capture (“true”) or later capture (“false”).	boolean		Não (Default false)
`IsCustomerBillPaymentService`	Indicates that the transfer is intended for bill payment	boolean		Yes
`SoftDescriptor`	Text that will be printed on the cardholder's bank statement. Special characters are not allowed. Must be filled in the format *WalletNamemerchantname**.	text	13	Yes
`Payment.CreditCard.CardNumber`	Buyer's card number.	string	19	Yes
`Payment.CreditCard.Holder`	Buyer's name printed on the card. Special characters or accents are not accepted.	string	25	Yes
`Payment.CreditCard.Brand`	Card brand. Possible values: Visa / Master / Amex / Elo / Aura / JCB / Diners / Discover.	string	10	Yes
`Payment.CreditCard.SecurityCode`	Security code printed on the back of the card.	string	4	Yes
`Payment.CreditCard.ExpirationDate`	Expiration date printed on the card. Example: MM/YYYY.	string	7	Yes
`Payment.Wallet.PlatformOperator`	Acronym of the wallet registered at Cielo as a digital wallet (check your acronym with your account manager).	string (text)	3	Yes
`Payment.Wallet.AdditionalData.Mcc`	Digital wallet MCC for unidentified bill payment transactions, according to the card brand. See the MCC Table for SDWO Fund Transfer Arrangement.	string (numeric)	4	Yes