---
title: "Delay order"
method: POST
path: "/v2/payments/{token}/delay"
tags: ["Orders"]
---

# Delay order

`POST /v2/payments/{token}/delay`

Request a delayed capture for the order. The payment schedule for the customer is created; however, no funds are settled until a capture call is made. Outstanding authorizations are automatically voided once the authorization expiry time is reached.

## Path parameters

- `token` string, string, required

## Headers

- `Idempotency-Key` string

## Request body

- object
  - `authorizationExpiryMilliseconds` integer, required — Length of time (in milliseconds) that the authorization is valid.
  - `merchantReference` string — Merchant reference for tracking the order in your system.

## Response `200`

Order delayed successfully

- object
  - `token` string, required — The order token.
  - `status` string, required — The current status of the order after delay.
  - `authorizationExpiryAt` string — The date and time when the authorization expires.
  - `totalAmount` object — The total amount of the order.
    - `amount` string — The amount value.
    - `currency` string — The currency code (ISO 4217).
  - `orderDetails` object — The full order details.

## Other responses

- `400` — Bad request
- `401` — Unauthorized
- `409` — Conflict

---

[API](https://skmtc.net/scalapay/apis/scalapay-api.md) · [All operations](https://skmtc.net/scalapay/apis/scalapay-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/scalapay/scalapay-api/revisions/c43238b80cb9/schema)