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.

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

Request

Environment

Method

Endpoint

Sandbox

https://apisandbox.cieloecommerce.cielo.com.br/1/sales/

Production

https://api.cieloecommerce.cielo.com.br/1/sales/

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

Header parameters

PropertyDescriptionTypeSizeRequired
MerchantIdMerchant identifier in the Cielo E-commerce API.GUID36Yes
MerchantKeyPublic key for dual authentication in the Cielo E-commerce API.string40Yes
RequestIdRequest identifier, used when the merchant uses different servers for each GET/POST/PUT.GUID36No

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

Shopper's name.
Note: Only characters a-z, A-Z are allowed. Special characters and numbers are not permitted.

string

255

Yes

Customer.Identity

Shopper's CPF or CNPJ number.

text

14

Yes, if the holder is a legal entity (CNPJ).

Customer.IdentityType

Type of shopper's identification document (CPF/CNPJ).

text

255

Yes, if the holder is a legal entity (CNPJ).

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

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 WalletName*merchantname.

text

13

Yes

Payment.CreditCard.CardNumber

Shopper's card number.

string

19

Yes

Payment.CreditCard.Holder

Shopper'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