Process transactions directly to your end-customers.
The POST Transaction endpoint enables customers to allocate insetting credits to their end customers within the FincoEnergies platform. This functionality is essential for managing the distribution of credits, ensuring that the sustainability efforts of your business are accurately reflected across your supply chain. By using this endpoint, you can specify the amount of credits to be allocated, the end-customer receiving the credits, and other relevant details, streamlining the process and maintaining precise records of all transactions. This feature is designed to support your sustainability strategy by making it easy to allocate and track credits efficiently.
Default request:
Parameters:
- No parameters
Request body:
{
"ProductID": "string"
"Reference": "string",
"EndCustomer": "string",
"EmissionsLifecycle": "",
"AmountOfCredits": 0
}- Reference - your internal reference, e.g. a SO number
- EndCustomer - the name of your EndCustomer, needs to be created first using the POST EndCustomer API.
- EmissionLifecycle - optional field, either 'WtW' (Well-to-wake) or 'TtW' (Tank-to-wake)
- AmountOfCredits - number (tCO2eq), up to three decimals behind comma.
- ProductID - unique ID, obtain via GET ProductCategories API.
Default response:
200: Default response:
{
"Message": "Transaction has been received and processed succesfully",
"TransactionID": "T-CM200000",
"Reference": "First Transaction",
"EmissionsLifecycle": "WtW",
"AmountOfCredits": 100.1,
"ProductID": "GS001"
}- TransactionID - represents the unique ID used by FincoEnergies, starting with CM2 and adding 5 other numbers.
422: Validation error response
{
"error": "Description of validation error."
}500: Default error response
{
"error": "Description of the error(s) that occurred."
}504: Timeout error response
{
"error": "Timeout waiting for response"
}