---
metadata:
  - name: generator
    content: Diplodoc Platform v5.55.0
alternate:
  - https://yandex.com/dev/market/partner-api/doc/en/step-by-step/laas-return.md
  - https://yandex.com/dev/market/partner-api/doc/ru/step-by-step/laas-return.md
  - https://yandex.com/dev/market/partner-api/doc/zh/step-by-step/laas-return.md
  - href: en/step-by-step/laas-return.md
    type: text/markdown
    title: Markdown version
  - href: ../llms.txt
    type: text/markdown
    title: llms.txt
---
> **Documentation Index:** Fetch the complete configuration index at https://yandex.com/dev/market/partner-api/doc/en/llms.txt


# Working with the LaaS refund

With the help Yandex Market API You can receive, create, and cancel refunds.


## Create a refund {#create}

<!-- source: en/_includes/mermaid/create-return.md -->
```mermaid
%%{
  init: {
    'theme': 'base',
    'themeVariables': {
      'primaryColor': '#FDF3E8',
      'primaryTextColor': '#000000',
      'primaryBorderColor': '#BA9C80',
      'lineColor': '#BA9C80',
      'secondaryColor': '#94E1C4',
      'tertiaryColor': '#F84E57',
      'noteBkgColor': '#FED58D'
    }
  }
}%%

sequenceDiagram
    participant Merchant as Your store
    participant Market as Yandex Market

    opt
        rect rgb(251, 243, 232)
            note right of Merchant: Optional step
            note right of Merchant: Getting the list of pickup points
            Merchant ->> Market: POST v1/businesses/{businessId}/logistics-points
            Market -->> Merchant: OK: list of pickup points with their IDs.
        end
    end

    rect rgb(251, 243, 232)
        note right of Merchant: Checking if pickup points are suitable for returning specified items
        Merchant ->> Market: Pickup point IDs and items<br>POST v1/campaigns/{campaignId}/return-delivery-options
        Market -->> Merchant: OK: suitable pickup points.
    end

    rect rgb(251, 243, 232)
        note right of Merchant: Creating a return
        Merchant ->>+ Market: POST v1/campaigns/{campaignId}/returns/create
        Market ->> Market: Creates a return.
        Market -->>- Merchant: OK: return ID.
    end
```
<!-- endsource: en/_includes/mermaid/create-return.md -->


1. If necessary, request a list of pick-up points using the method [POST v1/businesses/{businessId}/logistics-points](https://yandex.com/dev/market/partner-api/doc/en/reference/logistic-points/getLogisticPoints.md). Parameter `features` with the value `RETURN_ALLOWED` It will be refunded for those PVZS that accept refunds.

    Request this information regularly to keep up-to-date data in the store's system. For example, once a day.

1. Check if the pick-up points are suitable for returning the specified items. To do this, in the method [POST v1/campaigns/{campaignId}/return-delivery-options](https://yandex.com/dev/market/partner-api/doc/en/reference/delivery-options/getReturnDeliveryOptions.md) send the goods and the IDs of the pick-up points that accept refunds (have the attribute `RETURN_ALLOWED`).

1. Create a refund — [POST v1/campaigns/{campaignId}/returns/create](https://yandex.com/dev/market/partner-api/doc/en/reference/returns/createReturn.md).


## Cancel refund {#cancel}

{% note tip "Use this method in similar situations." %}

You have created a refund in which you specified 3 items. But the buyer changed his mind and decided to return only 2. Cancel the refund and create a new one.

{% endnote %}


<!-- source: en/_includes/mermaid/cancel-return.md -->
```mermaid
%%{
  init: {
    'theme': 'base',
    'themeVariables': {
      'primaryColor': '#FDF3E8',
      'primaryTextColor': '#000000',
      'primaryBorderColor': '#BA9C80',
      'lineColor': '#BA9C80',
      'secondaryColor': '#94E1C4',
      'tertiaryColor': '#F84E57',
      'noteBkgColor': '#FED58D'
    }
  }
}%%

sequenceDiagram
    participant Merchant as Your store
    participant Market as Yandex Market

    rect rgb(251, 243, 232)
        note right of Merchant: Return cancellation
        Merchant ->>+ Market: POST v2/campaigns/{campaignId}/returns/cancel
        Market ->> Market: Starts the operation<br>for return cancellation.
        Market -->>- Merchant: OK: operation identifier.
    end

    rect rgb(251, 243, 232)
        note right of Merchant: Operation status check
        Merchant ->> Market: Operation identifier<br>POST v2/businesses/{businessId}/operations
        Market -->> Merchant: OK: operation information.
    end
```
<!-- endsource: en/_includes/mermaid/cancel-return.md -->

1. Start the operation to cancel the refund — [POST v1/campaigns/{campaignId}/returns/cancel](https://yandex.com/dev/market/partner-api/doc/en/reference/returns/cancelReturn.md).

1. Check the operation status using the method [POST v1/businesses/{businessId}/operations](https://yandex.com/dev/market/partner-api/doc/en/reference/operations/getOperations.md).