Create purchase

post

https://customer.services.drelife.com/purchases/create

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

Time	Status	User Agent
Retrieving recent requests…

Loading…

Query Params

lang

string

required

Body Params

contact

object

required

The information of the customer who is making the purchase.

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

shippingMethodId

string

required

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

marketplaceId

string

The identifier of the marketplace where the purchase is made.

methodId

string

required

The identifier of the shipping method used for this purchase.

shippingType

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.

paymentMethod

string

enum

required

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

Allowed:

iban

string

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

holderName

string

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

termsAndConditionsAcceptance

boolean

required

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

Responses

400

Bad request.

401

Unauthorized.

403

No longer accepted.

404

Not Found.

201Information of the newly purchase created. The purchase status is 'pending' until the merchant accepts it.