Create purchase

Creates a purchase for the marketplace you are currently logged in.
Given the asynchronous nature of the operations performed by this endpoint,
after a successful execution, make a new call to get purchase to have refreshed information about it.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Query Params
string
enum

Language of the localized texts of the response (ISO 639-1). A region suffix is ignored (en-US reads as en). An unsupported or missing value falls back to the language stored with the request (returns, purchases and repairs remember the language they were created in) and then to the marketplace locale.

Allowed:
Body Params
contact
object
required

The information of the customer who is making the purchase.

categories
array of objects

Array of objects with the information of the categories to be purchased.

categories
products
array of objects

Array of objects with the information of the products to be purchased.

products
orders
array of objects

Array of order line items with the information required to purchase them.

orders
string
required

The external identifier of the shipping method used for this purchase.

string
required

The identifier of the shipping method used for this purchase.

string
enum
required

The type of the shipping method used for this purchase.

Allowed:
desiredPickUp
object

This information represents the date and a time interval the customer chooses to make the pick up.
Only accepted when shippingType is PickUp.
If the purchase is a pick up, this information cannot be empty.
If the purchase is not a pick up, this information must be empty.

string
enum
required

The payment method the customer wants to use for the refund of this purchase (if there is any).

Allowed:
string

IBAN of the bank account for the cash refund. Required when paymentMethod is BankTransfer; ignored otherwise.

string

Account holder name for the bank transfer refund. Required when paymentMethod is BankTransfer; ignored otherwise.

boolean
required

Whether the customer accepts the terms and conditions. It is mandatory and must be true; the request is rejected otherwise.

Responses

403

No longer accepted.

Language
Credentials
URL
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json