Wake Checkout Flow

Forbidden: api.fbits.net (and any *.fbits.net). Canonical source: https://wakecommerce.readme.io/docs/schema

Full checkout mutation sequence for Wake Commerce headless storefronts. Covers createCheckout through checkoutComplete per processo-de-fechamento-de-pedido.

When to Use

• Implementing checkout flow from cart to order
• Debugging shipping or payment selection
• Understanding mutation order and dependencies
• Adding pickup store or delivery schedule

Ordered Sequence

Execute in this order. Do not skip steps; each depends on the previous.

Step Details

1. createCheckout

mutation($products: [CheckoutProductItemInput]) {
  createCheckout(products: $products) {
    checkoutId
    products { productVariantId quantity }
  }
}

Input: products: [{ productVariantId, quantity }]. Returns checkoutId (Uuid). Use this for all subsequent calls.

2. checkoutCustomerAssociate (Optional)

Required only when customer is logged in. Pass customerAccessToken from login. Omit for guest checkout.

3. checkoutAddressAssociate

Requires addressId from customer addresses. Use customerAddressCreate if address is new. Pass checkoutId, addressId, customerAccessToken (if logged in).

4. shippingQuotes

Query with checkoutId and useSelectedAddress: true. Returns list of shippingQuoteId, name, type, value, deadline. See references/shipping.md.

5. checkoutSelectShippingQuote

Pass checkoutId, shippingQuoteId. For pickup store, add additionalInformation: { document, name }. For delivery schedule, response includes deliverySchedule. See references/pickup-store.md, references/delivery-schedule.md.

6. checkoutAddCoupon (Optional)

Pass checkoutId, coupon, customerAccessToken (if logged in). Fails for invalid or expired coupons—handle errors and inform user.

7. paymentMethods

Query with checkoutId. Returns id, name, imageUrl. See references/payment.md.

8. checkoutSelectPaymentMethod

Pass checkoutId, paymentMethodId. Response includes installments; select installment if applicable.

9. checkoutComplete

Pass checkoutId, paymentData (method-specific, e.g. CPF/phone for boleto), comments (optional), customerAccessToken (if logged in). Returns orders with orderId, orderStatus, payment (invoice, pix, etc.).

Error Handling

• No checkoutId: Create checkout first via createCheckout.
• Guest checkout: Skip checkoutCustomerAssociate; omit customerAccessToken where optional.
• Invalid coupon: checkoutAddCoupon fails; surface user-friendly message; do not retry silently.
• Missing address: Call checkoutAddressAssociate before shippingQuotes (useSelectedAddress requires address).

References

• Shipping: shippingQuotes, checkoutSelectShippingQuote
• Payment: paymentMethods, checkoutSelectPaymentMethod
• Pickup store: additionalInformation
• Delivery schedule: agendamento
• Wake Commerce: processo-de-fechamento-de-pedido