How to use the Sandbox

To facilitate testing during integration, Cielo offers a Sandbox environment that allows simulating the API messaging. The Sandbox environment is programmed with prepared responses for all functionalities provided in the Cielo E-commerce API.

INFORMATIONURL
Access credentialsMerchantId and MerchantKey obtained after creating a test account at Sandbox Registration.
Transactional URL basehttps://apisandbox.cieloecommerce.cielo.com.br
Query URL basehttps://apiquerysandbox.cieloecommerce.cielo.com.br

Advantages of using the sandbox

  • No affiliation is required to use the Cielo Sandbox.
  • Just access the Sandbox Registration to create an account.

To streamline testing during integration, Cielo provides a Sandbox environment that allows you to simulate API messaging. The Sandbox environment is preconfigured with prepared responses for all features provided by the API Cielo E-commerce.

ℹ️

No affiliation is required to use the Cielo Sandbox.

Base URLs for Sandbox:

INFORMATIONURL
Transactional base URLhttps://apisandbox.cieloecommerce.cielo.com.br
Query base URLhttps://apiquerysandbox.cieloecommerce.cielo.com.br

Get sandbox credentials

Click here to create an account and obtain sandbox credentials (MerchantId and MerchantKey) to test the API for free:

Make requests to the API according to this documentation, using your sandbox credentials.

Test the Notification Post

You can test the Notification Post in the Sandbox environment.

To understand how the feature works, see the documentation Notification Post.

To request the registration of the notification URL, send an email to [email protected] with:

  • Sandbox environment Merchant ID (MID);
  • URL to receive notifications;
  • Headers, if used.

To create and configure the notification URL, see Notification URLs.

ℹ️

Important

The notified events depend on the scenarios that can be simulated in the Sandbox environment.

Features enabled in the sandbox account

  • Credit Card: create, capture, query, and void payment;
  • Debit Card: create, query, and void payment;
  • Pix: create and query payment;
  • QR Code: create and query payment;
  • Recurring Payment: create recurring transaction;
  • Zero Auth: validate test card;
  • Consulta BIN: query card information;
  • Tokenization: create card token and process a transaction with a tokenized card.

Features that require activation in the sandbox environment

The following features are available only upon activation by Cielo Support:

  • Boleto Bancário;
  • Digital Wallets (E-wallets);
  • Silent Order Post;
  • Velocity Check;
  • Fraud Analysis (available only with the Risk Management product).

⚠️

Warning

The payment status for QR Code and Pix transactions in the sandbox will always be pending.

ℹ️

For 3DS authentication in the sandbox, use the credentials available in the documentation.