API architecture
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.
Updated about 2 months ago
What's next