Winkelstraat/stock hub/v2/order payment request

POST https://reseller.server.com/api/v2/stockhub/order-payment-request

The order payment request webhook performs a POST in JSON format to a designated endpoint of the reseller when a negotiable quote is submitted and an order is created. The V2 payload includes full order details: items, billing/shipping addresses, payment information, and totals.

Headers

x-version string Required

Version of the webhook.
x-api-key string

The API-key is a shared secret that can be used to authenticate the incoming request.

application/json

Body

order_increment_id string | null
purchase_order_increment_id string | null
pay_by_link string | null
created_at string | null
items array[object]
Hide items attributes Show items attributes object
- sku string
- parent_sku string | null
- qty integer
- item_price_inc_tax number(float)
- row_total_inc_tax number(float)
- manufacturer string | null
- size string | null
- mpn string | null
- external_reference string | null
billing_address object | null
Hide billing_address attributes Show billing_address attributes object | null
- first_name string | null
- last_name string | null
- email string | null
- telephone string | null
- street string | null
- house_number string | null
- postcode string | null
- city string | null
- region_code string | null
- country_id string | null
- company_name string | null
shipping_address object | null
Hide shipping_address attributes Show shipping_address attributes object | null
- first_name string | null
- last_name string | null
- email string | null
- telephone string | null
- street string | null
- house_number string | null
- postcode string | null
- city string | null
- region_code string | null
- country_id string | null
- company_name string | null
payment object | null
Hide payment attributes Show payment attributes object | null
- method string | null
- po_number string | null
grand_total number(float)
subtotal number(float)
shipping_price number | null
tax_amount number(float)
discount_amount number(float)
currency string | null

Responses

200

Ok
202

Accepted
406

Not accepted

POST winkelstraat/stock-hub/v2/order-payment-request

Request examples

# Headers
x-version: V1
x-api-key: string

# Payload
{
  "order_increment_id": "000000549",
  "purchase_order_increment_id": "000000001",
  "pay_by_link": "https://example.com/pay/abc123",
  "created_at": "2026-04-18T09:12:28.000+00:00",
  "items": [
    {
      "sku": "wsnl199-5c9de5ad4681ed3eb551e7ee",
      "parent_sku": "381189",
      "qty": 2,
      "item_price_inc_tax": 270,
      "row_total_inc_tax": 540,
      "manufacturer": "Emporio Armani",
      "size": "L",
      "mpn": "3G1MXE1MXVZF982",
      "external_reference": null
    }
  ],
  "billing_address": {
    "first_name": "Jan",
    "last_name": "Jansen",
    "email": "jan.jansen@winkelstraat.nl",
    "telephone": "+31621510775",
    "street": "Edsger Dijkstraat",
    "house_number": "12",
    "postcode": "9012DE",
    "city": "Zonnewijk",
    "region_code": null,
    "country_id": "NL",
    "company_name": null
  },
  "shipping_address": {
    "first_name": "Jan",
    "last_name": "Jansen",
    "email": "jan.jansen@winkelstraat.nl",
    "telephone": "+31621510775",
    "street": "Edsger Dijkstraat",
    "house_number": "12",
    "postcode": "9012DE",
    "city": "Zonnewijk",
    "region_code": null,
    "country_id": "NL",
    "company_name": null
  },
  "payment": {
    "method": "purchaseorder",
    "po_number": "YOUR_ORDER_REFERENCE"
  },
  "grand_total": 545.95,
  "subtotal": 540,
  "shipping_price": 5.95,
  "tax_amount": 94.64,
  "discount_amount": 0,
  "currency": "EUR"
}