{"info":{"_postman_id":"6b9d676f-588f-4437-b5b5-5911147f5afc","name":"Reward API","schema":"https://schema.getpostman.com/json/collection/v2.0.0/collection.json","toc":[],"description":"","owner":"7270651","collectionId":"6b9d676f-588f-4437-b5b5-5911147f5afc","publishedId":"2sBXqJL1HC","public":true,"customColor":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"2d5859"},"publishDate":"2026-04-29T08:01:40.000Z"},"item":[{"name":"Reward API Integration Orders","item":[{"name":"Login","id":"8e639e43-4499-4432-9add-719ffbde82d5","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"body":{"mode":"urlencoded","urlencoded":[{"key":"key","value":"DEMO","type":"text"},{"key":"secret","value":"secret_key","type":"text"}]},"url":"https://api.rewardcore.it/api/auth/login","description":"\n

Authenticates a client using a key and secret pair. On success, the API returns an access token that must be used in subsequent authenticated requests.

Request Details

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Property	Value
Method	`POST`
URL	`https://api.rewardcore.it/api/auth/login`
Body Type	`application/x-www-form-urlencoded`

Request Body Parameters

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Parameter	Type	Required	Description
`key`	`string`	✅ Yes	The client identifier key used to identify the application or integration (e.g., `DEMO`).
`secret`	`string`	✅ Yes	The client secret associated with the key, used to verify the client's identity.

Notes

Upon a successful authentication, the response typically contains a bearer token (or similar access token) that should be stored and passed in the Authorization header of subsequent API requests.
Ensure that the secret value is kept confidential and never exposed in public repositories or logs.
Use environment variables (e.g., {{X-API-KEY}}) to manage sensitive credentials securely within Postman.

\n","urlObject":{"protocol":"https","path":["api","auth","login"],"host":["api","rewardcore","it"],"query":[],"variable":[]}},"response":[],"_postman_id":"8e639e43-4499-4432-9add-719ffbde82d5"},{"name":"SendOrder","id":"6f5e550a-2388-412c-b2d9-fdc0bda0b7f4","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"noauth","isInherited":false},"method":"POST","header":[],"body":{"mode":"raw","raw":"{\r\n \"secret\": \"secret_key\",\r\n \"id\": \"12345\",\r\n \"order_date\": \"2023-06-19\",\r\n \"billing_business_name\": \"Nome Azienda\",\r\n \"billing_name\": \"\",\r\n \"billing_surname\": \"\",\r\n \"billing_address\": \"Via placeholder, 1\",\r\n \"billing_email\": \"user@azienda.it\",\r\n \"billing_province\": \"XX\",\r\n \"billing_city\": \"NOME CITTA\",\r\n \"billing_cap\": \"12345\",\r\n \"billing_telephone\": \"123456789\",\r\n \"billing_vat\": \"IT12345678945\",\r\n \"billing_fiscalcode\": \"1234567832145\",\r\n \"billing_cod_dest\": \"\",\r\n \"billing_pec\": \"\",\r\n \"shipping_business_name\": \"\",\r\n \"shipping_name\": \"\",\r\n \"shipping_surname\": \"\",\r\n \"shipping_address\": \"\",\r\n \"shipping_email\": \"\",\r\n \"shipping_province\": \"\",\r\n \"shipping_city\": \"\",\r\n \"shipping_cap\": \"\",\r\n \"shipping_telephone\": \"\",\r\n \"items\": [\r\n {\r\n \"external_ref\": \"PRODUCT_CODE\",\r\n \"qta\": \"X\",\r\n \"price\": \"XXXX\"\r\n }\r\n ],\r\n \"shipment_price\": \"0.0\",\r\n \"grand_total_amount\": \"XXXX\",\r\n \"note\": \"Esempio di note\"\r\n}","options":{"raw":{"language":"json"}}},"url":"https://api.rewardcore.it/api/v0/order/create","description":"

SendOrder

Creates a new order in the Reward Core platform.

Endpoint: POST https://api.rewardcore.it/api/v0/order/create

Request Body

The request body must be sent as raw JSON with the following fields:

Authentication

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Field	Type	Description
`secret`	string	Secret key used to authenticate the request

Order Info

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Field	Type	Description
`id`	string	Unique external identifier for the order
`order_date`	string (YYYY-MM-DD)	Date the order was placed
`note`	string	Optional notes for the order
`shipment_price`	string	Shipping cost (e.g. `\"0.0\"`)
`grand_total_amount`	string	Total order amount including all items and shipping

Billing Information

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Field	Type	Description
`billing_business_name`	string	Company/business name for billing
`billing_name`	string	First name of the billing contact
`billing_surname`	string	Last name of the billing contact
`billing_address`	string	Street address for billing
`billing_email`	string	Email address for billing
`billing_province`	string	Province/state code (2 chars)
`billing_city`	string	City name
`billing_cap`	string	Postal/ZIP code
`billing_telephone`	string	Phone number
`billing_vat`	string	VAT number (e.g. `IT12345678945`)
`billing_fiscalcode`	string	Fiscal code
`billing_cod_dest`	string	SDI destination code (for Italian e-invoicing)
`billing_pec`	string	Certified email address (PEC)

Shipping Information

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Field	Type	Description
`shipping_business_name`	string	Company/business name for shipping
`shipping_name`	string	First name of the shipping recipient
`shipping_surname`	string	Last name of the shipping recipient
`shipping_address`	string	Street address for shipping
`shipping_email`	string	Email address for shipping notifications
`shipping_province`	string	Province/state code
`shipping_city`	string	City name
`shipping_cap`	string	Postal/ZIP code
`shipping_telephone`	string	Phone number

Order Items

The items array contains one or more product entries:

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Field	Type	Description
`external_ref`	string	Product code / external reference
`qta`	string	Quantity ordered
`price`	string	Unit price of the product

Example Request Body

{\n    \"secret\": \"secret_key\",\n    \"id\": \"12345\",\n    \"order_date\": \"2023-06-19\",\n    \"billing_business_name\": \"Nome Azienda\",\n    \"billing_name\": \"\",\n    \"billing_surname\": \"\",\n    \"billing_address\": \"Via placeholder, 1\",\n    \"billing_email\": \"user@azienda.it\",\n    \"billing_province\": \"XX\",\n    \"billing_city\": \"NOME CITTA\",\n    \"billing_cap\": \"12345\",\n    \"billing_telephone\": \"123456789\",\n    \"billing_vat\": \"IT12345678945\",\n    \"billing_fiscalcode\": \"1234567832145\",\n    \"billing_cod_dest\": \"\",\n    \"billing_pec\": \"\",\n    \"shipping_business_name\": \"\",\n    \"shipping_name\": \"\",\n    \"shipping_surname\": \"\",\n    \"shipping_address\": \"\",\n    \"shipping_email\": \"\",\n    \"shipping_province\": \"\",\n    \"shipping_city\": \"\",\n    \"shipping_cap\": \"\",\n    \"shipping_telephone\": \"\",\n    \"items\": [\n        {\n            \"external_ref\": \"PRODUCT_CODE\",\n            \"qta\": \"X\",\n            \"price\": \"XXXX\"\n        }\n    ],\n    \"shipment_price\": \"0.0\",\n    \"grand_total_amount\": \"XXXX\",\n    \"note\": \"Esempio di note\"\n}\n

\n","urlObject":{"protocol":"https","path":["api","v0","order","create"],"host":["api","rewardcore","it"],"query":[],"variable":[]}},"response":[],"_postman_id":"6f5e550a-2388-412c-b2d9-fdc0bda0b7f4"},{"name":"GetShipment","event":[{"listen":"test","script":{"id":"97d1ad61-87cc-47cf-9035-921e533a784d","exec":["{\"status\":\"success\",\r"," \"message\":\"https:\\/\\/www.dhl.com\\/it-it\\/home\\/tracking\\/tracking-express.html?submit=1&tracking-id=XXXXXXX\",\r"," \"order_status\":\"EVASO\"\r","}"],"type":"text/javascript","packages":{},"requests":{}}}],"id":"bcfa5033-cbcc-42f4-8bc9-17f5aa45820f","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":""}]},"isInherited":false},"method":"POST","header":[],"body":{"mode":"raw","raw":"{\r\n \"secret\":\"secret_key\",\r\n \"order_id\" : \"12345\",\r\n \"external_ref\" : \"PRODUCT_CODE\"\r\n}","options":{"raw":{"language":"json"}}},"url":"https://api.rewardcore.it/api/v0/shipping/get","description":"

GetShipment

Retrieves shipment information associated with a specific order. This endpoint allows you to look up the shipping status and details for a given order by providing the order identifier and an optional external reference.

HTTP Method & URL

POST https://api.rewardcore.it/api/v0/shipping/get\n\n

Request Body

The request body must be sent as raw JSON (Content-Type: application/json).

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Field	Type	Required	Description
`secret`	`string`	✅ Yes	The secret API key used to authenticate the request.
`order_id`	`string`	✅ Yes	The unique identifier of the order whose shipment details you want to retrieve.
`external_ref`	`string`	⬜ Optional	An external reference code (e.g. product code or external system ID) associated with the order.

Example Request Body:

{\n    \"secret\": \"secret_key\",\n    \"order_id\": \"12345\",\n    \"external_ref\": \"PRODUCT_CODE\"\n}\n\n

Example Response:

{\n    \"status\":\"success\",\n    \"message\":\"https:\\/\\/www.dhl.com\\/it-it\\/home\\/tracking\\/tracking-express.html?submit=1&tracking-id=XXXXX\",\n    \"order_status\":\"EVASO\"\n}\n\n

Notes

The secret field acts as an API authentication token — ensure it is kept confidential and not exposed in client-side code.
\n
Use order_id to uniquely identify the order within the Reward Core platform.
\n
The external_ref field can be used to correlate the order with an identifier from an external system (e.g. a product code or third-party reference).
\n
This endpoint is typically used after an order has been placed (e.g. via SendOrder) to track its shipment progress.
\n

\n","urlObject":{"protocol":"https","path":["api","v0","shipping","get"],"host":["api","rewardcore","it"],"query":[],"variable":[]}},"response":[],"_postman_id":"bcfa5033-cbcc-42f4-8bc9-17f5aa45820f"}],"id":"6942bad0-ca50-4ab8-8c14-f5978baf336b","description":"

This folder covers the end-to-end order integration flow with the Reward platform (api.rewardcore.it). It contains three requests that must be executed in sequence:

Login – Authenticates against the Reward API using a client key and secret, obtaining the bearer token required for subsequent calls.
\n
SendOrder – Submits a new order to the platform, including full billing details, shipping information, line items, and totals.
\n
GetShipment – Retrieves the shipment status for a previously created order, identified by its order ID and product reference.
\n

\n","_postman_id":"6942bad0-ca50-4ab8-8c14-f5978baf336b"}]}