Skip to main content

An unpaid delivery is not ready for pickup

Reeds Engineering
Reeds Engineering
Developer platform

A delivery is ready for pickup only once it is paid for. Until then it has no pickup day and no delivery time.

What changed​

  • An unpaid delivery is saved with ready: false and schedule: null, whatever it was created with. A delivery is unpaid while it waits on BOOK, FUND_WALLET or PAY_INVOICE, or for a price. Only deliveries your team makes in the dashboard can wait like this.
  • Booked, it waits on MARK_READY. This applies to POST /deliveries/{id}/book, and to a booking that happens when the wallet is funded or credit frees up. The delivery is requires_action with a MARK_READY action and a tracking code. Before, it went straight to scheduled when it had been created as ready.
  • POST /deliveries/{id}/ready on an unpaid delivery is 409 ACTION_NOT_ALLOWED. It used to set ready: true and leave the delivery waiting.
  • Deliveries that were already waiting unpaid were changed to ready: false.

What you need to change​

Nothing, if you book from a quote: that booking is charged at once, so it keeps the ready you send, as before. If you book deliveries made in the dashboard, call POST /deliveries/{id}/ready after booking once the item is packed, or the delivery is cancelled and refunded after 7 days. See Requires action.