Environments
Sandbox
API | URL based |
---|---|
Request | https://apisandbox.cieloecommerce.cielo.com.br |
Queries | https://apiquerysandbox.cieloecommerce.cielo.com.br |
Production
API | URL based |
---|---|
Request | https://api.cieloecommerce.cielo.com.br/ |
Queries | https://apiquery.cieloecommerce.cielo.com.br/ |
Architeture
The model employed for the integration is quite simple since there are two URLs (endpoints):
- Requests URL: for operations that cause side effects - such as authorization, capture and cancellation of transactions
- Queries URL: for operations that do not cause side effects, such as transaction searching.
To execute an operation:
- Combine the base URL of the environment with the URL of the desired operation. Eg.: https://api.cieloecommerce.cielo.com.br/_1/sales/_
- Send the request to the URL using the adequate HTTP method.
Method | Description |
---|---|
POST | The POST HTTP method is used in the creation of features or in sending information that will be processed. For example, creation of a transaction. |
PUT | ThePUT HTTP method is used to update an already existing feature. For example, capture or cancelation of a previously authorized transaction. |
GET | The GET HTTP method is used for querying already existing features. For example, transaction query. |
All operations require the access credentials MerchantId
and MerchantKey
, which must be sent in the header (header) of the request.
Each request sent will return an HTTP Status Code, indicating whether it was carried out successfully or not.