---
title: "Submit return"
method: POST
path: "/application/return"
tags: ["Application"]
---

# Submit return

`POST /application/return`

Returns 200 when the request is parsed correctly. Further check returnLeaseInfo.isSuccess to ensure a successful return.

## Request body

- ReturnRequest — An object containing details of a return.
  - `applicationId` integer — This is the Account Number (AKA Lease ID) as assigned by Progressive Leasing.
  - `store` Store — An object that contains the details of the Merchant and their Store.
    - `progressiveMerchantId` integer — The Progressive supplied ID that designates your Progressive store number.
    - `merchantStoreId` string, nullable — This value is supplied by your organization. It is the value from your system which represents an individual store location. This information must be cross referenced to the Progressive System.
    - `salesAssociate` string, nullable — Store sales associate name/ID that is entering the lease application.
    - `merchantApplicationIdentifier` string, nullable — This is a store-specific field for passing a Merchant application's unique identifier.
    - `merchantTerminalId` string, nullable — Store terminal Id number, to be used in scenarios where a store's POS system is interacting with the endpoint.
    - `isNotifyStoreOnApplication` boolean — The Id of the application to patch or update.
    - `source` 'NotSet' | 'ProgCentral' | 'Tanc' | 'MyAccount' | 'CommerceApi' | 'Pos' | 'ProgAnywhere' | 'ProgConnect' | 'ProgMarketplaceSingleCart' — The Cart Source
  - `dateOfReturn` string, date-time, required — The date that a return was processed.
  - `merchandiseReturnAuthorization` string, nullable — A return authorization code, if given from Progressive Leasing. If provided, it must match the authorization code provided for the application ID.
  - `merchandiseItems` ReturnItem[], nullable — A list of line items to be returned.
    - `sku` string, nullable — The return item's SKU (stock-keeping unit).
    - `model` string, nullable — The model number of the return item. This should be the same as the model number used to purchase the item.
    - `relatedSku` string, nullable — The SKU (stock-keeping unit) used to identify which items on the invoice are related to other items on the invoice. For example, and inventory SKU can be related to a warranty SKU.
    - `description` string, nullable — A description of the item being returned.
    - `originalPriceEach` number, double — Specifies the original price of a return item. Optional.
    - `priceEach` number, double — The price of the item being returned. This amount is subtracted from the lease total.
    - `giftCardFee` number, double — A retailer fee charged to Progressive Leasing for gift cards. Optional.
    - `quantity` integer — The quantity of the items to return.
    - `actionType` string, nullable — The action being performed by the return request. Possible values are "Ordermod", "Purchase", "ConsumePP", "GiftCardCredit", "MissingPart", "PikcupFee", "PriceAdj", "ProratePP", "Restock", and "Return".
    - `invoiceNumber` string, nullable — The merchant provided ID of the invoice that contained the item that was purchased.
    - `refundReason` string, nullable — The the reason for refund.

## Response `200`

Success

- ReturnResponse — An object wrapping a return lease response and a purchase response.
  - `returnLeaseInfo` ReturnLeaseResponse — An object containing return information.
    - `authorizationCode` string, nullable — The progressive authorization code used to reference a return.
    - `returnAccountId` string, nullable — The Account Number (AKA Lease ID) of the processed return.
    - `isSuccess` boolean — Whether a return is successful.
    - `eSignURL` string, nullable — A unique URL to give to the customer to e-sign, if an application can be e-signed.
    - `message` string, nullable — A message containing remarks about the processed return.
    - `errorMessage` string, nullable — A message containing error details.
  - `purchaseLeaseInfo` PurchaseLeaseResponse — An object containing purchase info, if a purchase was made.
    - `purchaseAccountId` string, nullable — The Account Number (AKA Lease ID) of the new purchase.
    - `isSuccess` boolean — Whether a purchase request is successful.
    - `eSignURL` string, nullable — A unique URL to give to the customer to e-sign, if an application can be e-signed.
    - `message` string, nullable — A message containing remarks about the processed purchase.
    - `errorMessage` string, nullable — A message containing error details in the case that the purchase could not be processed.
    - `approvalLimit` number, double — The dollar amount a customer has been approved for.

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `500` — Internal Service Error

---

[API](https://skmtc.dev/progleasing/apis/progressive-leasing-commerce-api.md) · [All operations](https://skmtc.dev/progleasing/apis/progressive-leasing-commerce-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/progleasing/progressive-leasing-commerce-api/revisions/a51acdb02487/schema)