Sign in

v1

latestOpenAPI 3.0.02026-07-244074117.0 KB
Orders

Cancel a partial amount of an order

Cancel a partial amount of an order.

  • The cancelled amount will be posted as a credit toward the order balance once the order is finalized. This will not affect the original total amount.
  • This is supported for orders in approved, pending, submitted, open, opening, and finalizing statuses.
  • This is not allowed once order is finalized. To update finalized orders, use the adjustments endpoint.
  • You may also cancel on merchant dashboard.
post/v4/orders/{id}/partial-cancel

Path parameters

idstring required

The Slope order ID or the partner external order ID

Request body

amountnumber required

The amount to cancel, in cents.

Example request

{
  "amount": 100
}

Response

The partially cancelled order

idstring required

Slope Unique Order ID

externalIdstring

Unique merchant generated external ID

customerIdstring

Slope Customer ID, null until order is claimed by customer

numberstring required

Unique short & friendly order number

checkoutCodestring required

Unique code for Slope.JS widget

checkoutUrlstring required

Full URL for redirect flow

totalnumber required

Order total before customer fees

totalFinalizednumber

Total amount finalized for multi-finalization, null if not in finalizing/finalized state

merchantFeenumber required

Merchant fees

customerFeenumber required

Customer fees

customerFeePercentagenumber required

Customer fee percentage

totalWithFeesnumber required

Order total with customer fees

amountCanceledPrincipalnumber required

Amount canceled, in cents.

amountCanceledFeenumber required

Amount canceled, in cents.

status'pending' | 'approved' | 'submitted' | 'opening' | 'open' | 'finalizing' | 'finalized' | 'unpaid' | 'partiallyPaid' | 'complete' | 'defaulted' | 'rejected' | 'canceled' | 'refunded' | 'repayment' required
finalizedAtstring date-time required

Time when order was finalized, null if not finalized yet

openedAtstring date-time required

Time when order was opened, null if not open yet

currency'mxn' | 'usd' required
selectedTermNamestring

The selected payment term name. Null if not selected yet.

selectedPaymentType'ach' | 'card' | 'oxxo' | 'spei' | 'wire' | 'rtp' | 'customer_wallet' | 'virtual_card' | 'virtual_account'
selectedTermDaysnumber

The selected payment term days. Null if not selected yet.

metadataobject

Any additional metadata to attach to the order

amountOutstandingnumber required

Current amount outstanding on the order

aprnumber

Annual percentage rate from the selected quote. Null if no quote is selected yet.

Example response

{
  "paymentSchedule": [
    {
      "date": "2024-01-01"
    }
  ],
  "quotes": [
    {
      "payments": [
        {
          "number": 1,
          "date": "2024-02-15T00:00:00Z",
          "principal": 95000,
          "customerFee": 500,
          "amount": 105000,
          "financingFee": 2500
        }
      ]
    }
  ]
}