Create Operation

The Create operation is made in response to the creation of a Fast order by a Shopper. A Fast order is created when a Shopper clicks the Fast Checkout button on any page (e.g. PDP, mini-cart, checkout page, etc).

Create Request

POST
/fast/v1/create

Request Body schema: application/json

A create request.

type
string (v1EntityType)

The type of entity being created.

Enum: "ENTITY_TYPE_UNSPECIFIED" "ENTITY_TYPE_ORDER" "ENTITY_TYPE_SHIPPING_OPTION" "ENTITY_TYPE_USER" "ENTITY_TYPE_SHIPPING_ZONES"
app_id
string

The application ID for your store registered with Fast.

object (v1CreateRequestSegment)

Object containing the order information.

object (v1UUID)
application/json
{
  • "type": "ENTITY_TYPE_UNSPECIFIED",
  • "app_id": "string",
  • "order": {
    },
  • "request_id": {
    }
}

Create Response

Success (200)

A successful response.

Response Schema: application/json
type
string (v1EntityType)

The type of entity being created.

Enum: "ENTITY_TYPE_UNSPECIFIED" "ENTITY_TYPE_ORDER" "ENTITY_TYPE_SHIPPING_OPTION" "ENTITY_TYPE_USER" "ENTITY_TYPE_SHIPPING_ZONES"
object (v1CreateResponseSegment)

Fast order data entity.

object (v1UUID)

The idempotency key of request.

application/json
{
  • "type": "ENTITY_TYPE_UNSPECIFIED",
  • "order": {
    },
  • "request_id": {
    }
}

Error

An unexpected error response.

Response Schema: application/json
code
integer <int32>
message
string
Array of objects (protobufAny)
application/json
{
  • "code": 0,
  • "message": "string",
  • "details": [
    ]
}

Use Cases

Below are business cases that will trigger Fast to call the Create operation to the Seller.

Create a Cart

Create a Cart

A request to create a cart is fired when a Shopper clicks the Fast checkout button anywhere (PDP, Cart, Affiliate page). In Fast, a "cart" is an Order entity with a "status" equal to ORDER_STATUS_CART.

Request

{
  • "type": "ENTITY_TYPE_ORDER",
  • "order": {
    }
}

CreateRequest_Order_Cart

Response

{
  • "order": {
    }
}