Transactions & Orders

SCAYLE enables brands to manage complex B2B and B2C eCommerce transactions through its powerful order model. An order on SCAYLE is a structured record that holds all essential information about a customer’s purchase, including personal details, payment data, and fulfilment instructions.

What Makes Up an Order?

Each order in SCAYLE consists of the following key elements:

🧾 Billing Address

The billing address includes:

• Full name and title
• Street, house number, zip code, city, state, and country
• Phone number (optional)
• Customer type and reference key

📦 Shipping Address

Similar to billing, with additional fields to support collection points (e.g., parcel shops or lockers). Each shipping address is linked to the specific package(s) it applies to.

👤 Customer Information

Contains customer identifiers and optional metadata:

• Customer ID, reference key, public key
• First and last name, gender, birthdate
• Email and phone number
• Guest or registered status
• Loyalty program membership

💳 Payment Methods

SCAYLE supports multiple payment types per order. Each payment includes:

• Type (e.g., credit card, Ratepay, gift card)
• Transaction ID
• PSP references
• Authorization timestamps and success flags
• Gift card codes, if used

🎟 Vouchers, Promotions & Gift Cards

• Vouchers: Applied at order or item level; can be absolute or relative.
• Promotions: Automatically or manually applied; may affect pricing.
• Gift Cards: Can be used fully or partially; tracked through dedicated fields.

🌟 Loyalty Points

Orders may earn or redeem loyalty points based on configured rules. Return-related actions can trigger automatic point adjustments.

🛒 Items Ordered

Each order includes detailed line items:

• Product/variant IDs
• Quantity, unit prices (with/without tax)
• Applied discounts (sale, campaign, voucher)
• VAT rates and amounts
• Delivery forecasts per item

💰 Totals & Cost Structure

SCAYLE provides granular breakdowns:

• Item-level gross/net prices
• Tax totals
• Applied service costs (e.g., delivery, returns)
• Applied reductions (discounts, vouchers)
• Final order total (with and without service costs)

🚚 Shipping & Carriers

Orders include:

• Shipping policy and delivery windows (min/max)
• Carrier keys and shipment tracking URLs
• Shipping costs and express surcharges (if any)

📦 Packages

Orders can contain multiple packages, each with:

• Assigned items
• Delivery status
• Delivery date (promised vs. actual)
• Carrier and tracking information
• Return identifiers, if applicable