Create order

/v4/me/create_order

Target audience: Developers

Release version: 4.7.5

Create order¶

Introduction¶

This endpoint is used to place an order.

Attention

As for now this endpoint only supports creating orders with the payment method invoice, autogiro, billecta, free and adyen.

URI¶

Environment	URI
Stage	https://payway-api.stage.adeprimo.se/external/api/v4/me/create_order
Production	https://backend.worldoftulo.com/external/api/v4/me/create_order

Requirements¶

Identity	Scope
Yes	`/external/me/w`

Parameters¶

Field	Required	Type	Description
product_code	Required	String	The product code for a package/campaign.
period_id	Required	String	The unique id of the period that should be used for this order. Note that the supplied period id determines the payment method. Size range: ..24 Allowed values: "/^[a-f\d]{24}$/i"
start_date	Optional	DateTime	The start date of the subscription in UTC, will default to `DateTime.now`
receipt_url	Required	String	The receipt url that the user will end up on after creating the order
billing_address	Optional	Address object	Address object, that should be set as the billing address. Required if product is a physical/print product and period is not free
delivery_address	Optional	Address object	Address object, that should be set as the delivery address. Required if product is a physical/print product
einvoice_information	Optional	Object	Object containing invoicing information, if the order is an e-invoice subscription
gln	Optional	String	The GLN linked to the e-invoice
intermediator	Required	String	The intermediator linked to the e-invoice
crn	Required	String	The CRN linked to the e-invoice
traffic_source	Optional	String	The traffic source for the order
merchant_reference	Optional	String	The merchant reference for the order
paywall_id	Optional	String	The ID of the paywall. Size range: ..24 Allowed values: "/^[a-f\d]{24}$/i"
secure_identification	Optional	Object	The object containing information about the secure identification of a user
trusted_identity_id	Required	String	The ID of the trusted identity. Size range: ..24 Allowed values: "/^[a-f\d]{24}$/i"
omit_secure_identification	Optional	Boolean	Omit secure identification, use for example when creating orders of company subscriptions. Default value: false
voucher_purchase	Optional	Boolean	Set to true to create free voucher. Note that the period needs to have payment method free and voucher purchase for the product must be enabled in PAP. Read more here
voucher_details	Optional	Object	Voucher details object, Required if `voucher_purchase` is set to true
expire_date	Required	DateTime	Expire date for the voucher
account_payment_profile_id	Optional	String	The id of the stored account payment profile Required for online payments.
invoice_delivery_method	Optional	String	'mail' or 'email'. Delivery method of the invoice, only applicable when payment method is invoice. Requires support in the subscription system integration
client_info	Optional	Object	Information about the client, such as browser or device information.
user_agent	Required	String	User agent. E.g. Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/108.0.0.0 Safari/537.36
language	Required	String	Client langague. E.g. sv-SE
ip_address	Required	String	Client ip address. E.g. 111.111.1.11

Curl Basic Example¶

curl --request POST \
  --url https://payway-api.stage.adeprimo.se/external/api/4/me/create_order \
  --header 'accept: application/json' \
  --header 'authorization: Bearer <token-with-identity>' \
  --header 'content-type: application/json' \
  --data '{
              "product_code": "adeprimo_digital",
              "period_id": "5cb804811d41c82b5c518ea8",
              "start_date": "2019-05-01T00:00:00+00:00",
              "receipt_url": "https://domain.tld/receipt/585a4768edce2c5e6f000001"
          }'

With address¶

curl --request POST \
  --url https://payway-api.stage.adeprimo.se/external/api/v4/me/create_order \
  --header 'accept: application/json' \
  --header 'authorization: Bearer <token-with-identity>' \
  --header 'content-type: application/json' \
  --data '{
              "product_code": "adeprimo_digital",
              "period_id": "5cb804811d41c82b5c518ea8",
              "start_date": "2019-05-01T00:00:00+00:00",
              "receipt_url": "https://domain.tld/receipt/585a4768edce2c5e6f000001",
              "billing_address": {
                  "first_name": "Erik",
                  "last_name": "Eriksson",
                  "street": "Ekvägen",
                  "street_number": "12",
                  "zip_code": "120 35",
                  "city": "Tyresö",
                  "country_code": "SE",
                  "care_of": null,
                  "contact_email": "invoicing@no-reply.com",
                  "citizenship_country_code": "SE",
                  "company_name": "My Company",
                  "company_reference": null,
                  "company_department": "IT"
             },
             "delivery_address": {
                  "first_name": "Erik",
                  "last_name": "Eriksson",
                  "street": "Ekvägen",
                  "street_number": "12",
                  "zip_code": "120 35",
                  "city": "Tyresö",
                  "country_code": "SE",
                  "company_name": "My Company",
                  "company_reference": null,
                  "company_department": "IT"
             }
          }'

Response¶

Field	Description
id	id of the order
order_id	order_id of the order
payment_id	id of the payment

HTTP 201 Created
{
    "id": "ADEPRIMO-1234",
    "order_id": "ADEPRIMO-1234",
    "payment_id": "AAABBBCCDD11223344"
}

Errors¶

This API uses the common error conventions of the Payway API

See common error responses

Payway API - Order Placement