Affilibee
Toggle sidebar

Create order

API reference for sending completed orders from your platform into Affilibee for attribution and commission processing.

Endpoint

POST
/api/v2/orders/create

Authorization

Learn more
Authorization
string
header
required

The Bearer token generated in the Affilibee dashboard.

Body

application/json

affiliate_slug
string
required

The affiliate slug for the order. Slugs are stored in lowercase, so sending it in lowercase is recommended; other casings are accepted and converted. Validation: must exist, belong to the authenticated merchant, and be active.

order_no
string
required

Your unique order reference. Validation: must be unique and cannot exceed 255 characters.

total_shipping_value
numeric
required

Total shipping amount for the order. Validation: must be 0 or greater.

currency_code
string
required

Currency code for the order, such as USD or EUR. Validation: must exist in Affilibee and match the merchant account currency.

customer
object

Customer details to associate with the order. If you send this object, include the customer email.

order_rows
array
required

Line items included in the order. Validation: at least one order row is required; orders without order rows are rejected. Each row is validated independently.

Example requests

Responses

application/json

201
Created

Returned when the order is accepted for commission processing.

401
Unauthorized

Returned when the request does not include a valid Bearer token. See the Authentication page for the required token format.

403
Forbidden

Returned when a testing token is used on the live API, or a live token on the sandbox API.

422
Unprocessable Content

Returned when the request body fails validation.

Response examples

Notes

  • Send monetary values in the smallest currency unit, such as cents for USD.

  • If your platform sells in multiple currencies, convert values before submission and make sure they match the currency registered for the merchant account.

  • Submit the order only after your platform has captured the affiliate slug, stored the attribution, and determined that the order is valid to report.

Got questions? We're here for you.

We help teams run affiliate programs through API-first integrations that fit the platform they already use.

© 2025 Affilibee Handelsbolag (969802-2481)

Integrations

API Integration
How can we assist you today?

Fill in the form below and we'll get back to you as soon as possible.

Name
Email
Message