---
title: "Reject an order"
method: POST
path: "/v4/simulation/reject-order"
tags: ["Simulation"]
---

# Reject an order

`POST /v4/simulation/reject-order`

(Sandbox Only) Reject an order for testing purposes. This is a terminal state.

## Request body

- RejectOrderV4RequestDto
  - `orderId` string, required — The Slope ID or external ID of the order to reject

## Response `200`

The rejected order

- OrderEntityV4ResponseDto
  - `id` string, required — Slope Unique Order ID
  - `externalId` string — Unique merchant generated external ID
  - `customerId` string — Slope Customer ID, null until order is claimed by customer
  - `number` string, required — Unique short & friendly order number
  - `checkoutCode` string, required — Unique code for Slope.JS widget
  - `checkoutUrl` string, required — Full URL for redirect flow
  - `total` number, required — Order total before customer fees
  - `totalFinalized` number — Total amount finalized for multi-finalization, null if not in finalizing/finalized state
  - `merchantFee` number, required — Merchant fees
  - `customerFee` number, required — Customer fees
  - `customerFeePercentage` number, required — Customer fee percentage
  - `totalWithFees` number, required — Order total with customer fees
  - `amountCanceledPrincipal` number, required — Amount canceled, in cents.
  - `amountCanceledFee` number, required — Amount canceled, in cents.
  - `status` 'pending' | 'approved' | 'submitted' | 'opening' | 'open' | 'finalizing' | 'finalized' | 'unpaid' | 'partiallyPaid' | 'complete' | 'defaulted' | 'rejected' | 'canceled' | 'refunded' | 'repayment', required
  - `finalizedAt` string, date-time, required — Time when order was finalized, null if not finalized yet
  - `openedAt` string, date-time, required — Time when order was opened, null if not open yet
  - `currency` 'mxn' | 'usd', required
  - `selectedTermName` string — The selected payment term name. Null if not selected yet.
  - `selectedPaymentType` 'ach' | 'card' | 'oxxo' | 'spei' | 'wire' | 'rtp' | 'customer_wallet' | 'virtual_card' | 'virtual_account'
  - `selectedTermDays` number — The selected payment term days. Null if not selected yet.
  - `paymentSchedule` OrderPaymentScheduleV4ResponseDto[] — The payment schedules for the order
    - `amount` number, required — The amount due for this payment for the order
    - `date` string, date-time, required — The date the payment is due for the order in the format ISO-8601 (YYYY-MM-DD)
  - `metadata` object — Any additional metadata to attach to the order
  - `amountOutstanding` number, required — Current amount outstanding on the order
  - `apr` number — Annual percentage rate from the selected quote. Null if no quote is selected yet.
  - `quotes` QuoteV4ResponseDto[] — Quotes available for this order
    - `id` string, required
    - `name` string, required
    - `expiresAt` string, required
    - `status` 'approved' | 'rejected', required
    - `processingFeeTotal` number, required
    - `totalWithFinancingFees` number, required
    - `totalWithFees` number, required
    - `financingFeePct` number, required
    - `financingFeeTotal` number, required
    - `apr` number, required
    - `payments` SchedulePaymentSharedDto[], required
      - `number` number, required — The payment number in the schedule sequence
      - `date` string, date-time, required — The due date for this payment
      - `principal` number, required — The principal amount of this payment, in cents
      - `customerFee` number, required — The customer fee for this payment, in cents
      - `amount` number, required — The total amount due for this payment, in cents
      - `financingFee` number, required — The financing fee for this payment, in cents

---

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