{
  "info": {
    "name": "AvantPay API",
    "description": "Методы API AvantPay — платежи, способы оплаты и возвраты: по запросу на метод, тела запросов и примеры ответов — из справочника https://avantpay.io/developers/api/.\n\nПеред первым запросом впишите в переменные коллекции `shopId` — ID магазина и `secretKey` — секретный ключ. Заголовок `Idempotence-Key` — `{{$guid}}`: при каждой отправке новый UUID.\n\nОписание API в формате OpenAPI: https://avantpay.io/developers/openapi.json",
    "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json"
  },
  "auth": {
    "type": "basic",
    "basic": [
      {
        "key": "username",
        "value": "{{shopId}}",
        "type": "string"
      },
      {
        "key": "password",
        "value": "{{secretKey}}",
        "type": "string"
      }
    ]
  },
  "variable": [
    {
      "key": "baseUrl",
      "value": "https://api.avantpay.io",
      "description": "Адрес API без версии: пути запросов начинаются с /v3.",
      "type": "string"
    },
    {
      "key": "shopId",
      "value": "",
      "description": "ID магазина — логин HTTP Basic.",
      "type": "string"
    },
    {
      "key": "secretKey",
      "value": "",
      "description": "Секретный ключ — пароль HTTP Basic.",
      "type": "string"
    }
  ],
  "item": [
    {
      "name": "Платежи",
      "item": [
        {
          "name": "Создать платёж",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Idempotence-Key",
                "value": "{{$guid}}",
                "description": "Ключ идемпотентности: уникальная строка до 64 символов, лучше UUID. Новый для каждой попытки оплаты, тот же при повторе запроса. [Подробнее](https://avantpay.io/developers/api/#idempotence)"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "body": {
              "mode": "raw",
              "raw": "{\n  \"amount\": {\n    \"value\": \"1000.00\",\n    \"currency\": \"RUB\"\n  },\n  \"capture\": true,\n  \"confirmation\": {\n    \"type\": \"redirect\",\n    \"return_url\": \"https://example.com/orders/123\"\n  },\n  \"description\": \"Заказ №123\",\n  \"metadata\": {\n    \"email\": \"buyer@example.com\",\n    \"order_id\": \"123\"\n  }\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            },
            "url": {
              "raw": "{{baseUrl}}/v3/payments",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v3",
                "payments"
              ]
            },
            "description": "Создаёт платёж и возвращает [объект платежа](https://avantpay.io/developers/api/#payment_object) со статусом `pending` и ссылкой на оплату `confirmation.confirmation_url`.\n\n> **Важно.**\n>\n> Email покупателя обязателен: передайте его в `metadata.email`. Покупатель из Telegram — `<telegram_id>@telegram.org`, например `123456789@telegram.org`.\n\nСправочник: https://avantpay.io/developers/api/#create_payment"
          },
          "response": [
            {
              "name": "объект платежа со ссылкой на оплату",
              "originalRequest": {
                "method": "POST",
                "header": [
                  {
                    "key": "Idempotence-Key",
                    "value": "{{$guid}}",
                    "description": "Ключ идемпотентности: уникальная строка до 64 символов, лучше UUID. Новый для каждой попытки оплаты, тот же при повторе запроса. [Подробнее](https://avantpay.io/developers/api/#idempotence)"
                  },
                  {
                    "key": "Content-Type",
                    "value": "application/json"
                  }
                ],
                "body": {
                  "mode": "raw",
                  "raw": "{\n  \"amount\": {\n    \"value\": \"1000.00\",\n    \"currency\": \"RUB\"\n  },\n  \"capture\": true,\n  \"confirmation\": {\n    \"type\": \"redirect\",\n    \"return_url\": \"https://example.com/orders/123\"\n  },\n  \"description\": \"Заказ №123\",\n  \"metadata\": {\n    \"email\": \"buyer@example.com\",\n    \"order_id\": \"123\"\n  }\n}",
                  "options": {
                    "raw": {
                      "language": "json"
                    }
                  }
                },
                "url": {
                  "raw": "{{baseUrl}}/v3/payments",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "v3",
                    "payments"
                  ]
                }
              },
              "status": "OK",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "cookie": [],
              "body": "{\n  \"id\": \"3d6f0a8e-5b2c-4e1f-9a7d-2c4b6e8f0a1b\",\n  \"status\": \"pending\",\n  \"paid\": false,\n  \"amount\": {\n    \"value\": \"1000.00\",\n    \"currency\": \"RUB\"\n  },\n  \"description\": \"Заказ №123\",\n  \"recipient\": {\n    \"account_id\": \"33661\"\n  },\n  \"created_at\": \"2026-10-18T10:15:30.123Z\",\n  \"expires_at\": \"2026-10-18T10:35:30.123Z\",\n  \"confirmation\": {\n    \"type\": \"redirect\",\n    \"confirmation_url\": \"https://avantpay.io/checkout?paymentId=3d6f0a8e-5b2c-4e1f-9a7d-2c4b6e8f0a1b\",\n    \"return_url\": \"https://example.com/orders/123\"\n  },\n  \"test\": false,\n  \"refundable\": false,\n  \"metadata\": {\n    \"email\": \"buyer@example.com\",\n    \"order_id\": \"123\"\n  }\n}"
            },
            {
              "name": "неверный email покупателя",
              "originalRequest": {
                "method": "POST",
                "header": [
                  {
                    "key": "Idempotence-Key",
                    "value": "{{$guid}}",
                    "description": "Ключ идемпотентности: уникальная строка до 64 символов, лучше UUID. Новый для каждой попытки оплаты, тот же при повторе запроса. [Подробнее](https://avantpay.io/developers/api/#idempotence)"
                  },
                  {
                    "key": "Content-Type",
                    "value": "application/json"
                  }
                ],
                "body": {
                  "mode": "raw",
                  "raw": "{\n  \"amount\": {\n    \"value\": \"1000.00\",\n    \"currency\": \"RUB\"\n  },\n  \"capture\": true,\n  \"confirmation\": {\n    \"type\": \"redirect\",\n    \"return_url\": \"https://example.com/orders/123\"\n  },\n  \"description\": \"Заказ №123\",\n  \"metadata\": {\n    \"email\": \"buyer@example.com\",\n    \"order_id\": \"123\"\n  }\n}",
                  "options": {
                    "raw": {
                      "language": "json"
                    }
                  }
                },
                "url": {
                  "raw": "{{baseUrl}}/v3/payments",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "v3",
                    "payments"
                  ]
                }
              },
              "status": "Bad Request",
              "code": 400,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "cookie": [],
              "body": "{\n  \"type\": \"error\",\n  \"id\": \"2b7d4e9a-1c3f-4a5b-8d6e-7f0a1b2c3d4e\",\n  \"code\": \"invalid_request\",\n  \"description\": \"metadata.email must be the buyer's email address (up to 254 characters), for a Telegram buyer use <id or username>@telegram.org\",\n  \"parameter\": \"metadata.email\"\n}"
            }
          ]
        },
        {
          "name": "Получить платёж",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{baseUrl}}/v3/payments/:payment_id",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v3",
                "payments",
                ":payment_id"
              ],
              "variable": [
                {
                  "key": "payment_id",
                  "value": "2f9b6c1e-4d7a-4c3b-9e8f-1a2b3c4d5e6f",
                  "description": "`id` платежа из ответа на его создание."
                }
              ]
            },
            "description": "Возвращает [объект платежа](https://avantpay.io/developers/api/#payment_object) в текущем состоянии.\n\nСправочник: https://avantpay.io/developers/api/#get_payment"
          },
          "response": [
            {
              "name": "объект платежа, оплаченного картой",
              "originalRequest": {
                "method": "GET",
                "header": [],
                "url": {
                  "raw": "{{baseUrl}}/v3/payments/:payment_id",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "v3",
                    "payments",
                    ":payment_id"
                  ],
                  "variable": [
                    {
                      "key": "payment_id",
                      "value": "2f9b6c1e-4d7a-4c3b-9e8f-1a2b3c4d5e6f",
                      "description": "`id` платежа из ответа на его создание."
                    }
                  ]
                }
              },
              "status": "OK",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "cookie": [],
              "body": "{\n  \"id\": \"2f9b6c1e-4d7a-4c3b-9e8f-1a2b3c4d5e6f\",\n  \"status\": \"succeeded\",\n  \"paid\": true,\n  \"amount\": {\n    \"value\": \"1000.00\",\n    \"currency\": \"RUB\"\n  },\n  \"income_amount\": {\n    \"value\": \"975.00\",\n    \"currency\": \"RUB\"\n  },\n  \"description\": \"Заказ №123\",\n  \"recipient\": {\n    \"account_id\": \"33661\",\n    \"gateway_id\": \"6b1f3c0a-58e2-4f7d-9a41-0c2d7e5b8f93\"\n  },\n  \"payment_method\": {\n    \"type\": \"bank_card\",\n    \"id\": \"2f9b6c1e-4d7a-4c3b-9e8f-1a2b3c4d5e6f\",\n    \"saved\": false,\n    \"status\": \"inactive\",\n    \"title\": \"Банковская карта\"\n  },\n  \"captured_at\": \"2026-10-18T10:17:02.418Z\",\n  \"created_at\": \"2026-10-18T10:15:30.123Z\",\n  \"expires_at\": \"2026-10-18T10:35:30.123Z\",\n  \"confirmation\": {\n    \"type\": \"redirect\",\n    \"confirmation_url\": \"https://avantpay.io/checkout?paymentId=2f9b6c1e-4d7a-4c3b-9e8f-1a2b3c4d5e6f\",\n    \"return_url\": \"https://example.com/orders/123\"\n  },\n  \"test\": false,\n  \"refundable\": true,\n  \"metadata\": {\n    \"email\": \"buyer@example.com\",\n    \"order_id\": \"123\"\n  }\n}"
            }
          ]
        },
        {
          "name": "Список платежей",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{baseUrl}}/v3/payments?status=succeeded&created_at.gte=2026-10-01T00:00:00.000Z&limit=2",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v3",
                "payments"
              ],
              "query": [
                {
                  "key": "status",
                  "value": "succeeded",
                  "description": "Только платежи с этим статусом: `pending`, `succeeded` или `canceled`."
                },
                {
                  "key": "created_at.gte",
                  "value": "2026-10-01T00:00:00.000Z",
                  "description": "Созданы в этот момент или позже. Указывается по [UTC](https://ru.wikipedia.org/wiki/%D0%92%D1%81%D0%B5%D0%BC%D0%B8%D1%80%D0%BD%D0%BE%D0%B5_%D0%BA%D0%BE%D0%BE%D1%80%D0%B4%D0%B8%D0%BD%D0%B8%D1%80%D0%BE%D0%B2%D0%B0%D0%BD%D0%BD%D0%BE%D0%B5_%D0%B2%D1%80%D0%B5%D0%BC%D1%8F) и передаётся в формате [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601). Пример: `2026-10-01T00:00:00.000Z`."
                },
                {
                  "key": "limit",
                  "value": "2",
                  "description": "Сколько платежей на странице: от 1 до 100. По умолчанию 10."
                },
                {
                  "key": "cursor",
                  "value": "MjAyNi0xMC0xN1QxODozOTo1NS44NzFa",
                  "description": "Значение `next_cursor` из предыдущего ответа — чтобы получить следующую страницу. Передавайте как есть.",
                  "disabled": true
                },
                {
                  "key": "payment_method",
                  "value": "sbp",
                  "description": "Только платежи этим способом: `sbp` или `bank_card`.",
                  "disabled": true
                },
                {
                  "key": "created_at.gt",
                  "value": "2026-10-01T00:00:00.000Z",
                  "description": "Созданы позже этого момента. Указывается по [UTC](https://ru.wikipedia.org/wiki/%D0%92%D1%81%D0%B5%D0%BC%D0%B8%D1%80%D0%BD%D0%BE%D0%B5_%D0%BA%D0%BE%D0%BE%D1%80%D0%B4%D0%B8%D0%BD%D0%B8%D1%80%D0%BE%D0%B2%D0%B0%D0%BD%D0%BD%D0%BE%D0%B5_%D0%B2%D1%80%D0%B5%D0%BC%D1%8F) и передаётся в формате [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601). Пример: `2026-10-01T00:00:00.000Z`.",
                  "disabled": true
                },
                {
                  "key": "created_at.lte",
                  "value": "2026-10-31T23:59:59.999Z",
                  "description": "Созданы в этот момент или раньше. Указывается по [UTC](https://ru.wikipedia.org/wiki/%D0%92%D1%81%D0%B5%D0%BC%D0%B8%D1%80%D0%BD%D0%BE%D0%B5_%D0%BA%D0%BE%D0%BE%D1%80%D0%B4%D0%B8%D0%BD%D0%B8%D1%80%D0%BE%D0%B2%D0%B0%D0%BD%D0%BD%D0%BE%D0%B5_%D0%B2%D1%80%D0%B5%D0%BC%D1%8F) и передаётся в формате [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601). Пример: `2026-10-31T23:59:59.999Z`.",
                  "disabled": true
                },
                {
                  "key": "created_at.lt",
                  "value": "2026-11-01T00:00:00.000Z",
                  "description": "Созданы раньше этого момента. Указывается по [UTC](https://ru.wikipedia.org/wiki/%D0%92%D1%81%D0%B5%D0%BC%D0%B8%D1%80%D0%BD%D0%BE%D0%B5_%D0%BA%D0%BE%D0%BE%D1%80%D0%B4%D0%B8%D0%BD%D0%B8%D1%80%D0%BE%D0%B2%D0%B0%D0%BD%D0%BD%D0%BE%D0%B5_%D0%B2%D1%80%D0%B5%D0%BC%D1%8F) и передаётся в формате [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601). Пример: `2026-11-01T00:00:00.000Z`.",
                  "disabled": true
                },
                {
                  "key": "captured_at.gte",
                  "value": "2026-10-01T00:00:00.000Z",
                  "description": "Оплачены в этот момент или позже. Указывается по [UTC](https://ru.wikipedia.org/wiki/%D0%92%D1%81%D0%B5%D0%BC%D0%B8%D1%80%D0%BD%D0%BE%D0%B5_%D0%BA%D0%BE%D0%BE%D1%80%D0%B4%D0%B8%D0%BD%D0%B8%D1%80%D0%BE%D0%B2%D0%B0%D0%BD%D0%BD%D0%BE%D0%B5_%D0%B2%D1%80%D0%B5%D0%BC%D1%8F) и передаётся в формате [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601). Пример: `2026-10-01T00:00:00.000Z`.",
                  "disabled": true
                },
                {
                  "key": "captured_at.gt",
                  "value": "2026-10-01T00:00:00.000Z",
                  "description": "Оплачены позже этого момента. Указывается по [UTC](https://ru.wikipedia.org/wiki/%D0%92%D1%81%D0%B5%D0%BC%D0%B8%D1%80%D0%BD%D0%BE%D0%B5_%D0%BA%D0%BE%D0%BE%D1%80%D0%B4%D0%B8%D0%BD%D0%B8%D1%80%D0%BE%D0%B2%D0%B0%D0%BD%D0%BD%D0%BE%D0%B5_%D0%B2%D1%80%D0%B5%D0%BC%D1%8F) и передаётся в формате [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601). Пример: `2026-10-01T00:00:00.000Z`.",
                  "disabled": true
                },
                {
                  "key": "captured_at.lte",
                  "value": "2026-10-31T23:59:59.999Z",
                  "description": "Оплачены в этот момент или раньше. Указывается по [UTC](https://ru.wikipedia.org/wiki/%D0%92%D1%81%D0%B5%D0%BC%D0%B8%D1%80%D0%BD%D0%BE%D0%B5_%D0%BA%D0%BE%D0%BE%D1%80%D0%B4%D0%B8%D0%BD%D0%B8%D1%80%D0%BE%D0%B2%D0%B0%D0%BD%D0%BD%D0%BE%D0%B5_%D0%B2%D1%80%D0%B5%D0%BC%D1%8F) и передаётся в формате [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601). Пример: `2026-10-31T23:59:59.999Z`.",
                  "disabled": true
                },
                {
                  "key": "captured_at.lt",
                  "value": "2026-11-01T00:00:00.000Z",
                  "description": "Оплачены раньше этого момента. Указывается по [UTC](https://ru.wikipedia.org/wiki/%D0%92%D1%81%D0%B5%D0%BC%D0%B8%D1%80%D0%BD%D0%BE%D0%B5_%D0%BA%D0%BE%D0%BE%D1%80%D0%B4%D0%B8%D0%BD%D0%B8%D1%80%D0%BE%D0%B2%D0%B0%D0%BD%D0%BD%D0%BE%D0%B5_%D0%B2%D1%80%D0%B5%D0%BC%D1%8F) и передаётся в формате [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601). Пример: `2026-11-01T00:00:00.000Z`.",
                  "disabled": true
                }
              ]
            },
            "description": "Возвращает платежи вашего магазина от новых к старым. Можно отфильтровать по дате, статусу и способу оплаты. Список отдаётся страницами. Заголовок `Idempotence-Key` этому методу не нужен. Тела у запроса нет.\n\nСправочник: https://avantpay.io/developers/api/#get_payments_list"
          },
          "response": [
            {
              "name": "объект списка, первая страница",
              "originalRequest": {
                "method": "GET",
                "header": [],
                "url": {
                  "raw": "{{baseUrl}}/v3/payments?status=succeeded&created_at.gte=2026-10-01T00:00:00.000Z&limit=2",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "v3",
                    "payments"
                  ],
                  "query": [
                    {
                      "key": "status",
                      "value": "succeeded",
                      "description": "Только платежи с этим статусом: `pending`, `succeeded` или `canceled`."
                    },
                    {
                      "key": "created_at.gte",
                      "value": "2026-10-01T00:00:00.000Z",
                      "description": "Созданы в этот момент или позже. Указывается по [UTC](https://ru.wikipedia.org/wiki/%D0%92%D1%81%D0%B5%D0%BC%D0%B8%D1%80%D0%BD%D0%BE%D0%B5_%D0%BA%D0%BE%D0%BE%D1%80%D0%B4%D0%B8%D0%BD%D0%B8%D1%80%D0%BE%D0%B2%D0%B0%D0%BD%D0%BD%D0%BE%D0%B5_%D0%B2%D1%80%D0%B5%D0%BC%D1%8F) и передаётся в формате [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601). Пример: `2026-10-01T00:00:00.000Z`."
                    },
                    {
                      "key": "limit",
                      "value": "2",
                      "description": "Сколько платежей на странице: от 1 до 100. По умолчанию 10."
                    },
                    {
                      "key": "cursor",
                      "value": "MjAyNi0xMC0xN1QxODozOTo1NS44NzFa",
                      "description": "Значение `next_cursor` из предыдущего ответа — чтобы получить следующую страницу. Передавайте как есть.",
                      "disabled": true
                    },
                    {
                      "key": "payment_method",
                      "value": "sbp",
                      "description": "Только платежи этим способом: `sbp` или `bank_card`.",
                      "disabled": true
                    },
                    {
                      "key": "created_at.gt",
                      "value": "2026-10-01T00:00:00.000Z",
                      "description": "Созданы позже этого момента. Указывается по [UTC](https://ru.wikipedia.org/wiki/%D0%92%D1%81%D0%B5%D0%BC%D0%B8%D1%80%D0%BD%D0%BE%D0%B5_%D0%BA%D0%BE%D0%BE%D1%80%D0%B4%D0%B8%D0%BD%D0%B8%D1%80%D0%BE%D0%B2%D0%B0%D0%BD%D0%BD%D0%BE%D0%B5_%D0%B2%D1%80%D0%B5%D0%BC%D1%8F) и передаётся в формате [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601). Пример: `2026-10-01T00:00:00.000Z`.",
                      "disabled": true
                    },
                    {
                      "key": "created_at.lte",
                      "value": "2026-10-31T23:59:59.999Z",
                      "description": "Созданы в этот момент или раньше. Указывается по [UTC](https://ru.wikipedia.org/wiki/%D0%92%D1%81%D0%B5%D0%BC%D0%B8%D1%80%D0%BD%D0%BE%D0%B5_%D0%BA%D0%BE%D0%BE%D1%80%D0%B4%D0%B8%D0%BD%D0%B8%D1%80%D0%BE%D0%B2%D0%B0%D0%BD%D0%BD%D0%BE%D0%B5_%D0%B2%D1%80%D0%B5%D0%BC%D1%8F) и передаётся в формате [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601). Пример: `2026-10-31T23:59:59.999Z`.",
                      "disabled": true
                    },
                    {
                      "key": "created_at.lt",
                      "value": "2026-11-01T00:00:00.000Z",
                      "description": "Созданы раньше этого момента. Указывается по [UTC](https://ru.wikipedia.org/wiki/%D0%92%D1%81%D0%B5%D0%BC%D0%B8%D1%80%D0%BD%D0%BE%D0%B5_%D0%BA%D0%BE%D0%BE%D1%80%D0%B4%D0%B8%D0%BD%D0%B8%D1%80%D0%BE%D0%B2%D0%B0%D0%BD%D0%BD%D0%BE%D0%B5_%D0%B2%D1%80%D0%B5%D0%BC%D1%8F) и передаётся в формате [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601). Пример: `2026-11-01T00:00:00.000Z`.",
                      "disabled": true
                    },
                    {
                      "key": "captured_at.gte",
                      "value": "2026-10-01T00:00:00.000Z",
                      "description": "Оплачены в этот момент или позже. Указывается по [UTC](https://ru.wikipedia.org/wiki/%D0%92%D1%81%D0%B5%D0%BC%D0%B8%D1%80%D0%BD%D0%BE%D0%B5_%D0%BA%D0%BE%D0%BE%D1%80%D0%B4%D0%B8%D0%BD%D0%B8%D1%80%D0%BE%D0%B2%D0%B0%D0%BD%D0%BD%D0%BE%D0%B5_%D0%B2%D1%80%D0%B5%D0%BC%D1%8F) и передаётся в формате [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601). Пример: `2026-10-01T00:00:00.000Z`.",
                      "disabled": true
                    },
                    {
                      "key": "captured_at.gt",
                      "value": "2026-10-01T00:00:00.000Z",
                      "description": "Оплачены позже этого момента. Указывается по [UTC](https://ru.wikipedia.org/wiki/%D0%92%D1%81%D0%B5%D0%BC%D0%B8%D1%80%D0%BD%D0%BE%D0%B5_%D0%BA%D0%BE%D0%BE%D1%80%D0%B4%D0%B8%D0%BD%D0%B8%D1%80%D0%BE%D0%B2%D0%B0%D0%BD%D0%BD%D0%BE%D0%B5_%D0%B2%D1%80%D0%B5%D0%BC%D1%8F) и передаётся в формате [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601). Пример: `2026-10-01T00:00:00.000Z`.",
                      "disabled": true
                    },
                    {
                      "key": "captured_at.lte",
                      "value": "2026-10-31T23:59:59.999Z",
                      "description": "Оплачены в этот момент или раньше. Указывается по [UTC](https://ru.wikipedia.org/wiki/%D0%92%D1%81%D0%B5%D0%BC%D0%B8%D1%80%D0%BD%D0%BE%D0%B5_%D0%BA%D0%BE%D0%BE%D1%80%D0%B4%D0%B8%D0%BD%D0%B8%D1%80%D0%BE%D0%B2%D0%B0%D0%BD%D0%BD%D0%BE%D0%B5_%D0%B2%D1%80%D0%B5%D0%BC%D1%8F) и передаётся в формате [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601). Пример: `2026-10-31T23:59:59.999Z`.",
                      "disabled": true
                    },
                    {
                      "key": "captured_at.lt",
                      "value": "2026-11-01T00:00:00.000Z",
                      "description": "Оплачены раньше этого момента. Указывается по [UTC](https://ru.wikipedia.org/wiki/%D0%92%D1%81%D0%B5%D0%BC%D0%B8%D1%80%D0%BD%D0%BE%D0%B5_%D0%BA%D0%BE%D0%BE%D1%80%D0%B4%D0%B8%D0%BD%D0%B8%D1%80%D0%BE%D0%B2%D0%B0%D0%BD%D0%BD%D0%BE%D0%B5_%D0%B2%D1%80%D0%B5%D0%BC%D1%8F) и передаётся в формате [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601). Пример: `2026-11-01T00:00:00.000Z`.",
                      "disabled": true
                    }
                  ]
                }
              },
              "status": "OK",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "cookie": [],
              "body": "{\n  \"type\": \"list\",\n  \"items\": [\n    {\n      \"id\": \"2f9b6c1e-4d7a-4c3b-9e8f-1a2b3c4d5e6f\",\n      \"status\": \"succeeded\",\n      \"paid\": true,\n      \"amount\": {\n        \"value\": \"1000.00\",\n        \"currency\": \"RUB\"\n      },\n      \"income_amount\": {\n        \"value\": \"975.00\",\n        \"currency\": \"RUB\"\n      },\n      \"description\": \"Заказ №123\",\n      \"recipient\": {\n        \"account_id\": \"33661\",\n        \"gateway_id\": \"6b1f3c0a-58e2-4f7d-9a41-0c2d7e5b8f93\"\n      },\n      \"payment_method\": {\n        \"type\": \"bank_card\",\n        \"id\": \"2f9b6c1e-4d7a-4c3b-9e8f-1a2b3c4d5e6f\",\n        \"saved\": false,\n        \"status\": \"inactive\",\n        \"title\": \"Банковская карта\"\n      },\n      \"captured_at\": \"2026-10-18T10:17:02.418Z\",\n      \"created_at\": \"2026-10-18T10:15:30.123Z\",\n      \"expires_at\": \"2026-10-18T10:35:30.123Z\",\n      \"confirmation\": {\n        \"type\": \"redirect\",\n        \"confirmation_url\": \"https://avantpay.io/checkout?paymentId=2f9b6c1e-4d7a-4c3b-9e8f-1a2b3c4d5e6f\",\n        \"return_url\": \"https://example.com/orders/123\"\n      },\n      \"test\": false,\n      \"refundable\": true,\n      \"metadata\": {\n        \"email\": \"buyer@example.com\",\n        \"order_id\": \"123\"\n      }\n    },\n    {\n      \"id\": \"c4a8e2f1-9b3d-4f6a-8e1c-7d2b5a9f3e60\",\n      \"status\": \"succeeded\",\n      \"paid\": true,\n      \"amount\": {\n        \"value\": \"250.00\",\n        \"currency\": \"RUB\"\n      },\n      \"income_amount\": {\n        \"value\": \"243.75\",\n        \"currency\": \"RUB\"\n      },\n      \"description\": \"Заказ №122\",\n      \"recipient\": {\n        \"account_id\": \"33661\",\n        \"gateway_id\": \"6b1f3c0a-58e2-4f7d-9a41-0c2d7e5b8f93\"\n      },\n      \"payment_method\": {\n        \"type\": \"sbp\",\n        \"id\": \"c4a8e2f1-9b3d-4f6a-8e1c-7d2b5a9f3e60\",\n        \"saved\": false,\n        \"status\": \"inactive\",\n        \"title\": \"СБП\"\n      },\n      \"captured_at\": \"2026-10-17T18:41:09.004Z\",\n      \"created_at\": \"2026-10-17T18:39:55.871Z\",\n      \"expires_at\": \"2026-10-17T18:59:55.871Z\",\n      \"confirmation\": {\n        \"type\": \"redirect\",\n        \"confirmation_url\": \"https://avantpay.io/checkout?paymentId=c4a8e2f1-9b3d-4f6a-8e1c-7d2b5a9f3e60\",\n        \"return_url\": \"https://example.com/orders/122\"\n      },\n      \"test\": false,\n      \"refunded_amount\": {\n        \"value\": \"50.00\",\n        \"currency\": \"RUB\"\n      },\n      \"refundable\": true,\n      \"metadata\": {\n        \"email\": \"buyer@example.com\",\n        \"order_id\": \"122\"\n      }\n    }\n  ],\n  \"next_cursor\": \"MjAyNi0xMC0xN1QxODozOTo1NS44NzFafGM0YThlMmYxLTliM2QtNGY2YS04ZTFjLTdkMmI1YTlmM2U2MA\"\n}"
            },
            {
              "name": "фильтр по номеру заказа не поддерживается",
              "originalRequest": {
                "method": "GET",
                "header": [],
                "url": {
                  "raw": "{{baseUrl}}/v3/payments?status=succeeded&created_at.gte=2026-10-01T00:00:00.000Z&limit=2",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "v3",
                    "payments"
                  ],
                  "query": [
                    {
                      "key": "status",
                      "value": "succeeded",
                      "description": "Только платежи с этим статусом: `pending`, `succeeded` или `canceled`."
                    },
                    {
                      "key": "created_at.gte",
                      "value": "2026-10-01T00:00:00.000Z",
                      "description": "Созданы в этот момент или позже. Указывается по [UTC](https://ru.wikipedia.org/wiki/%D0%92%D1%81%D0%B5%D0%BC%D0%B8%D1%80%D0%BD%D0%BE%D0%B5_%D0%BA%D0%BE%D0%BE%D1%80%D0%B4%D0%B8%D0%BD%D0%B8%D1%80%D0%BE%D0%B2%D0%B0%D0%BD%D0%BD%D0%BE%D0%B5_%D0%B2%D1%80%D0%B5%D0%BC%D1%8F) и передаётся в формате [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601). Пример: `2026-10-01T00:00:00.000Z`."
                    },
                    {
                      "key": "limit",
                      "value": "2",
                      "description": "Сколько платежей на странице: от 1 до 100. По умолчанию 10."
                    },
                    {
                      "key": "cursor",
                      "value": "MjAyNi0xMC0xN1QxODozOTo1NS44NzFa",
                      "description": "Значение `next_cursor` из предыдущего ответа — чтобы получить следующую страницу. Передавайте как есть.",
                      "disabled": true
                    },
                    {
                      "key": "payment_method",
                      "value": "sbp",
                      "description": "Только платежи этим способом: `sbp` или `bank_card`.",
                      "disabled": true
                    },
                    {
                      "key": "created_at.gt",
                      "value": "2026-10-01T00:00:00.000Z",
                      "description": "Созданы позже этого момента. Указывается по [UTC](https://ru.wikipedia.org/wiki/%D0%92%D1%81%D0%B5%D0%BC%D0%B8%D1%80%D0%BD%D0%BE%D0%B5_%D0%BA%D0%BE%D0%BE%D1%80%D0%B4%D0%B8%D0%BD%D0%B8%D1%80%D0%BE%D0%B2%D0%B0%D0%BD%D0%BD%D0%BE%D0%B5_%D0%B2%D1%80%D0%B5%D0%BC%D1%8F) и передаётся в формате [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601). Пример: `2026-10-01T00:00:00.000Z`.",
                      "disabled": true
                    },
                    {
                      "key": "created_at.lte",
                      "value": "2026-10-31T23:59:59.999Z",
                      "description": "Созданы в этот момент или раньше. Указывается по [UTC](https://ru.wikipedia.org/wiki/%D0%92%D1%81%D0%B5%D0%BC%D0%B8%D1%80%D0%BD%D0%BE%D0%B5_%D0%BA%D0%BE%D0%BE%D1%80%D0%B4%D0%B8%D0%BD%D0%B8%D1%80%D0%BE%D0%B2%D0%B0%D0%BD%D0%BD%D0%BE%D0%B5_%D0%B2%D1%80%D0%B5%D0%BC%D1%8F) и передаётся в формате [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601). Пример: `2026-10-31T23:59:59.999Z`.",
                      "disabled": true
                    },
                    {
                      "key": "created_at.lt",
                      "value": "2026-11-01T00:00:00.000Z",
                      "description": "Созданы раньше этого момента. Указывается по [UTC](https://ru.wikipedia.org/wiki/%D0%92%D1%81%D0%B5%D0%BC%D0%B8%D1%80%D0%BD%D0%BE%D0%B5_%D0%BA%D0%BE%D0%BE%D1%80%D0%B4%D0%B8%D0%BD%D0%B8%D1%80%D0%BE%D0%B2%D0%B0%D0%BD%D0%BD%D0%BE%D0%B5_%D0%B2%D1%80%D0%B5%D0%BC%D1%8F) и передаётся в формате [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601). Пример: `2026-11-01T00:00:00.000Z`.",
                      "disabled": true
                    },
                    {
                      "key": "captured_at.gte",
                      "value": "2026-10-01T00:00:00.000Z",
                      "description": "Оплачены в этот момент или позже. Указывается по [UTC](https://ru.wikipedia.org/wiki/%D0%92%D1%81%D0%B5%D0%BC%D0%B8%D1%80%D0%BD%D0%BE%D0%B5_%D0%BA%D0%BE%D0%BE%D1%80%D0%B4%D0%B8%D0%BD%D0%B8%D1%80%D0%BE%D0%B2%D0%B0%D0%BD%D0%BD%D0%BE%D0%B5_%D0%B2%D1%80%D0%B5%D0%BC%D1%8F) и передаётся в формате [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601). Пример: `2026-10-01T00:00:00.000Z`.",
                      "disabled": true
                    },
                    {
                      "key": "captured_at.gt",
                      "value": "2026-10-01T00:00:00.000Z",
                      "description": "Оплачены позже этого момента. Указывается по [UTC](https://ru.wikipedia.org/wiki/%D0%92%D1%81%D0%B5%D0%BC%D0%B8%D1%80%D0%BD%D0%BE%D0%B5_%D0%BA%D0%BE%D0%BE%D1%80%D0%B4%D0%B8%D0%BD%D0%B8%D1%80%D0%BE%D0%B2%D0%B0%D0%BD%D0%BD%D0%BE%D0%B5_%D0%B2%D1%80%D0%B5%D0%BC%D1%8F) и передаётся в формате [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601). Пример: `2026-10-01T00:00:00.000Z`.",
                      "disabled": true
                    },
                    {
                      "key": "captured_at.lte",
                      "value": "2026-10-31T23:59:59.999Z",
                      "description": "Оплачены в этот момент или раньше. Указывается по [UTC](https://ru.wikipedia.org/wiki/%D0%92%D1%81%D0%B5%D0%BC%D0%B8%D1%80%D0%BD%D0%BE%D0%B5_%D0%BA%D0%BE%D0%BE%D1%80%D0%B4%D0%B8%D0%BD%D0%B8%D1%80%D0%BE%D0%B2%D0%B0%D0%BD%D0%BD%D0%BE%D0%B5_%D0%B2%D1%80%D0%B5%D0%BC%D1%8F) и передаётся в формате [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601). Пример: `2026-10-31T23:59:59.999Z`.",
                      "disabled": true
                    },
                    {
                      "key": "captured_at.lt",
                      "value": "2026-11-01T00:00:00.000Z",
                      "description": "Оплачены раньше этого момента. Указывается по [UTC](https://ru.wikipedia.org/wiki/%D0%92%D1%81%D0%B5%D0%BC%D0%B8%D1%80%D0%BD%D0%BE%D0%B5_%D0%BA%D0%BE%D0%BE%D1%80%D0%B4%D0%B8%D0%BD%D0%B8%D1%80%D0%BE%D0%B2%D0%B0%D0%BD%D0%BD%D0%BE%D0%B5_%D0%B2%D1%80%D0%B5%D0%BC%D1%8F) и передаётся в формате [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601). Пример: `2026-11-01T00:00:00.000Z`.",
                      "disabled": true
                    }
                  ]
                }
              },
              "status": "Bad Request",
              "code": 400,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "cookie": [],
              "body": "{\n  \"type\": \"error\",\n  \"id\": \"4c2e8a1f-6b3d-4f5a-9e7c-0b1d2e3f4a5b\",\n  \"code\": \"not_supported\",\n  \"description\": \"order_id is not supported: save the payment id in your order and get the payment with GET /v3/payments/{payment_id}\",\n  \"parameter\": \"order_id\"\n}"
            }
          ]
        }
      ]
    },
    {
      "name": "Способы оплаты",
      "item": [
        {
          "name": "Создать способ оплаты",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Idempotence-Key",
                "value": "{{$guid}}",
                "description": "Ключ идемпотентности: уникальная строка до 64 символов. [Подробнее](https://avantpay.io/developers/api/#idempotence)"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "body": {
              "mode": "raw",
              "raw": "{\n  \"type\": \"bank_card\",\n  \"confirmation\": {\n    \"type\": \"redirect\",\n    \"return_url\": \"https://example.com/account/cards\"\n  },\n  \"metadata\": {\n    \"customer_id\": \"1042\"\n  }\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            },
            "url": {
              "raw": "{{baseUrl}}/v3/payment_methods",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v3",
                "payment_methods"
              ]
            },
            "description": "Создаёт способ оплаты — банковскую карту — без платежа и возвращает [объект способа оплаты](https://avantpay.io/developers/api/#payment_method_object) в статусе `pending` со ссылкой `confirmation.confirmation_url`. Перенаправьте покупателя по ссылке: он подтвердит карту, на ней заблокируется и сразу вернётся 1 ₽. Когда карта сохранится, статус станет `active` и придёт уведомление `payment_method.active`. Ссылка действует 1 час.\n\n> **Важно.**\n>\n> Автоплатежи и сохранение карты без платежа включает поддержка AvantPay по письму на support@avantpay.io. Без этого API ответит 403 `forbidden`.\n\nСправочник: https://avantpay.io/developers/api/#create_payment_method"
          },
          "response": [
            {
              "name": "способ оплаты ждёт подтверждения покупателем",
              "originalRequest": {
                "method": "POST",
                "header": [
                  {
                    "key": "Idempotence-Key",
                    "value": "{{$guid}}",
                    "description": "Ключ идемпотентности: уникальная строка до 64 символов. [Подробнее](https://avantpay.io/developers/api/#idempotence)"
                  },
                  {
                    "key": "Content-Type",
                    "value": "application/json"
                  }
                ],
                "body": {
                  "mode": "raw",
                  "raw": "{\n  \"type\": \"bank_card\",\n  \"confirmation\": {\n    \"type\": \"redirect\",\n    \"return_url\": \"https://example.com/account/cards\"\n  },\n  \"metadata\": {\n    \"customer_id\": \"1042\"\n  }\n}",
                  "options": {
                    "raw": {
                      "language": "json"
                    }
                  }
                },
                "url": {
                  "raw": "{{baseUrl}}/v3/payment_methods",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "v3",
                    "payment_methods"
                  ]
                }
              },
              "status": "OK",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "cookie": [],
              "body": "{\n  \"type\": \"bank_card\",\n  \"id\": \"9d4c2b1a-6e5f-4a3b-8c7d-1e2f3a4b5c6d\",\n  \"saved\": false,\n  \"status\": \"pending\",\n  \"holder\": {\n    \"account_id\": \"33661\"\n  },\n  \"metadata\": {\n    \"customer_id\": \"1042\"\n  },\n  \"confirmation\": {\n    \"type\": \"redirect\",\n    \"confirmation_url\": \"https://avantpay.io/checkout/bind?paymentMethodId=9d4c2b1a-6e5f-4a3b-8c7d-1e2f3a4b5c6d\",\n    \"return_url\": \"https://example.com/account/cards\"\n  }\n}"
            },
            {
              "name": "сохранить СБП без платежа нельзя",
              "originalRequest": {
                "method": "POST",
                "header": [
                  {
                    "key": "Idempotence-Key",
                    "value": "{{$guid}}",
                    "description": "Ключ идемпотентности: уникальная строка до 64 символов. [Подробнее](https://avantpay.io/developers/api/#idempotence)"
                  },
                  {
                    "key": "Content-Type",
                    "value": "application/json"
                  }
                ],
                "body": {
                  "mode": "raw",
                  "raw": "{\n  \"type\": \"bank_card\",\n  \"confirmation\": {\n    \"type\": \"redirect\",\n    \"return_url\": \"https://example.com/account/cards\"\n  },\n  \"metadata\": {\n    \"customer_id\": \"1042\"\n  }\n}",
                  "options": {
                    "raw": {
                      "language": "json"
                    }
                  }
                },
                "url": {
                  "raw": "{{baseUrl}}/v3/payment_methods",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "v3",
                    "payment_methods"
                  ]
                }
              },
              "status": "Bad Request",
              "code": 400,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "cookie": [],
              "body": "{\n  \"type\": \"error\",\n  \"id\": \"4b2d6f8a-1c3e-4a5b-9d7f-0e2a4c6b8d1f\",\n  \"code\": \"not_supported\",\n  \"description\": \"type sbp is not supported for saving without a payment: create a payment with save_payment_method: true\",\n  \"parameter\": \"type\"\n}"
            }
          ]
        },
        {
          "name": "Получить способ оплаты",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{baseUrl}}/v3/payment_methods/:payment_method_id",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v3",
                "payment_methods",
                ":payment_method_id"
              ],
              "variable": [
                {
                  "key": "payment_method_id",
                  "value": "9d4c2b1a-6e5f-4a3b-8c7d-1e2f3a4b5c6d",
                  "description": "ID способа оплаты: `payment_method.id` из платежа или `id` из ответа на создание способа."
                }
              ]
            },
            "description": "Возвращает [объект способа оплаты](https://avantpay.io/developers/api/#payment_method_object) в текущем состоянии.\n\nСправочник: https://avantpay.io/developers/api/#get_payment_method"
          },
          "response": [
            {
              "name": "карта сохранена",
              "originalRequest": {
                "method": "GET",
                "header": [],
                "url": {
                  "raw": "{{baseUrl}}/v3/payment_methods/:payment_method_id",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "v3",
                    "payment_methods",
                    ":payment_method_id"
                  ],
                  "variable": [
                    {
                      "key": "payment_method_id",
                      "value": "9d4c2b1a-6e5f-4a3b-8c7d-1e2f3a4b5c6d",
                      "description": "ID способа оплаты: `payment_method.id` из платежа или `id` из ответа на создание способа."
                    }
                  ]
                }
              },
              "status": "OK",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "cookie": [],
              "body": "{\n  \"type\": \"bank_card\",\n  \"id\": \"9d4c2b1a-6e5f-4a3b-8c7d-1e2f3a4b5c6d\",\n  \"saved\": true,\n  \"status\": \"active\",\n  \"title\": \"Bank card *4444\",\n  \"card\": {\n    \"first6\": \"220220\",\n    \"last4\": \"4444\",\n    \"expiry_month\": \"07\",\n    \"expiry_year\": \"2030\",\n    \"card_type\": \"Mir\",\n    \"issuer_country\": \"RU\",\n    \"issuer_name\": \"Sberbank\"\n  },\n  \"holder\": {\n    \"account_id\": \"33661\"\n  },\n  \"metadata\": {\n    \"customer_id\": \"1042\"\n  }\n}"
            },
            {
              "name": "способа оплаты нет у магазина",
              "originalRequest": {
                "method": "GET",
                "header": [],
                "url": {
                  "raw": "{{baseUrl}}/v3/payment_methods/:payment_method_id",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "v3",
                    "payment_methods",
                    ":payment_method_id"
                  ],
                  "variable": [
                    {
                      "key": "payment_method_id",
                      "value": "9d4c2b1a-6e5f-4a3b-8c7d-1e2f3a4b5c6d",
                      "description": "ID способа оплаты: `payment_method.id` из платежа или `id` из ответа на создание способа."
                    }
                  ]
                }
              },
              "status": "Not Found",
              "code": 404,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "cookie": [],
              "body": "{\n  \"type\": \"error\",\n  \"id\": \"7e3a5c1b-9d2f-4b6a-8c4e-2f1d3b5a7c9e\",\n  \"code\": \"not_found\",\n  \"description\": \"Payment method with the specified id was not found\",\n  \"parameter\": \"payment_method_id\"\n}"
            }
          ]
        }
      ]
    },
    {
      "name": "Возвраты",
      "item": [
        {
          "name": "Создать возврат",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Idempotence-Key",
                "value": "{{$guid}}",
                "description": "Ключ идемпотентности: уникальная строка до 64 символов. Один ключ — один возврат: новый для каждого возврата, тот же при повторе запроса. [Подробнее](https://avantpay.io/developers/api/#idempotence)"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "body": {
              "mode": "raw",
              "raw": "{\n  \"payment_id\": \"2f9b6c1e-4d7a-4c3b-9e8f-1a2b3c4d5e6f\",\n  \"amount\": {\n    \"value\": \"300.00\",\n    \"currency\": \"RUB\"\n  },\n  \"description\": \"Возврат по заказу №123\",\n  \"metadata\": {\n    \"order_id\": \"123\"\n  }\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            },
            "url": {
              "raw": "{{baseUrl}}/v3/refunds",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v3",
                "refunds"
              ]
            },
            "description": "Создаёт возврат по оплаченному платежу и возвращает [объект возврата](https://avantpay.io/developers/api/#refund_object). У нового возврата статус `pending`. Можно вернуть всю сумму платежа или часть. Деньги вернутся покупателю тем же способом, которым он платил.\n\n> **Важно.**\n>\n> Для возвратов у ключа должно быть включено право «Возвраты». По умолчанию оно выключено: его включает поддержка AvantPay по письму на support@avantpay.io. Без права API ответит 403 `forbidden`.\n\nСправочник: https://avantpay.io/developers/api/#create_refund"
          },
          "response": [
            {
              "name": "новый возврат в статусе pending",
              "originalRequest": {
                "method": "POST",
                "header": [
                  {
                    "key": "Idempotence-Key",
                    "value": "{{$guid}}",
                    "description": "Ключ идемпотентности: уникальная строка до 64 символов. Один ключ — один возврат: новый для каждого возврата, тот же при повторе запроса. [Подробнее](https://avantpay.io/developers/api/#idempotence)"
                  },
                  {
                    "key": "Content-Type",
                    "value": "application/json"
                  }
                ],
                "body": {
                  "mode": "raw",
                  "raw": "{\n  \"payment_id\": \"2f9b6c1e-4d7a-4c3b-9e8f-1a2b3c4d5e6f\",\n  \"amount\": {\n    \"value\": \"300.00\",\n    \"currency\": \"RUB\"\n  },\n  \"description\": \"Возврат по заказу №123\",\n  \"metadata\": {\n    \"order_id\": \"123\"\n  }\n}",
                  "options": {
                    "raw": {
                      "language": "json"
                    }
                  }
                },
                "url": {
                  "raw": "{{baseUrl}}/v3/refunds",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "v3",
                    "refunds"
                  ]
                }
              },
              "status": "OK",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "cookie": [],
              "body": "{\n  \"id\": \"5e1d7c3a-9b2f-4a6e-8d4c-0f3b2a1e9c87\",\n  \"payment_id\": \"2f9b6c1e-4d7a-4c3b-9e8f-1a2b3c4d5e6f\",\n  \"status\": \"pending\",\n  \"created_at\": \"2026-10-19T09:40:12.305Z\",\n  \"amount\": {\n    \"value\": \"300.00\",\n    \"currency\": \"RUB\"\n  },\n  \"description\": \"Возврат по заказу №123\",\n  \"metadata\": {\n    \"order_id\": \"123\"\n  }\n}"
            },
            {
              "name": "по платежу уже выполняется возврат",
              "originalRequest": {
                "method": "POST",
                "header": [
                  {
                    "key": "Idempotence-Key",
                    "value": "{{$guid}}",
                    "description": "Ключ идемпотентности: уникальная строка до 64 символов. Один ключ — один возврат: новый для каждого возврата, тот же при повторе запроса. [Подробнее](https://avantpay.io/developers/api/#idempotence)"
                  },
                  {
                    "key": "Content-Type",
                    "value": "application/json"
                  }
                ],
                "body": {
                  "mode": "raw",
                  "raw": "{\n  \"payment_id\": \"2f9b6c1e-4d7a-4c3b-9e8f-1a2b3c4d5e6f\",\n  \"amount\": {\n    \"value\": \"300.00\",\n    \"currency\": \"RUB\"\n  },\n  \"description\": \"Возврат по заказу №123\",\n  \"metadata\": {\n    \"order_id\": \"123\"\n  }\n}",
                  "options": {
                    "raw": {
                      "language": "json"
                    }
                  }
                },
                "url": {
                  "raw": "{{baseUrl}}/v3/refunds",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "v3",
                    "refunds"
                  ]
                }
              },
              "status": "Bad Request",
              "code": 400,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "cookie": [],
              "body": "{\n  \"type\": \"error\",\n  \"id\": \"8f2a6d1c-3e5b-4c7a-9d0e-1b2c3d4e5f60\",\n  \"code\": \"invalid_request\",\n  \"description\": \"Another refund of this payment is in progress: wait until it is succeeded or canceled, then retry with a new Idempotence-Key\",\n  \"parameter\": \"payment_id\"\n}"
            },
            {
              "name": "у ключа не включено право «Возвраты»",
              "originalRequest": {
                "method": "POST",
                "header": [
                  {
                    "key": "Idempotence-Key",
                    "value": "{{$guid}}",
                    "description": "Ключ идемпотентности: уникальная строка до 64 символов. Один ключ — один возврат: новый для каждого возврата, тот же при повторе запроса. [Подробнее](https://avantpay.io/developers/api/#idempotence)"
                  },
                  {
                    "key": "Content-Type",
                    "value": "application/json"
                  }
                ],
                "body": {
                  "mode": "raw",
                  "raw": "{\n  \"payment_id\": \"2f9b6c1e-4d7a-4c3b-9e8f-1a2b3c4d5e6f\",\n  \"amount\": {\n    \"value\": \"300.00\",\n    \"currency\": \"RUB\"\n  },\n  \"description\": \"Возврат по заказу №123\",\n  \"metadata\": {\n    \"order_id\": \"123\"\n  }\n}",
                  "options": {
                    "raw": {
                      "language": "json"
                    }
                  }
                },
                "url": {
                  "raw": "{{baseUrl}}/v3/refunds",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "v3",
                    "refunds"
                  ]
                }
              },
              "status": "Forbidden",
              "code": 403,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "cookie": [],
              "body": "{\n  \"type\": \"error\",\n  \"id\": \"3c7e1a9b-5d2f-4b8e-a6c4-9e0f1d2c3b4a\",\n  \"code\": \"forbidden\",\n  \"description\": \"Refunds via the API are disabled for this API key: contact AvantPay support\"\n}"
            }
          ]
        },
        {
          "name": "Получить возврат",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{baseUrl}}/v3/refunds/:refund_id",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v3",
                "refunds",
                ":refund_id"
              ],
              "variable": [
                {
                  "key": "refund_id",
                  "value": "5e1d7c3a-9b2f-4a6e-8d4c-0f3b2a1e9c87",
                  "description": "`id` возврата из ответа на его создание или из списка возвратов."
                }
              ]
            },
            "description": "Возвращает [объект возврата](https://avantpay.io/developers/api/#refund_object) в текущем состоянии.\n\nСправочник: https://avantpay.io/developers/api/#get_refund"
          },
          "response": [
            {
              "name": "объект возврата, деньги вернули покупателю",
              "originalRequest": {
                "method": "GET",
                "header": [],
                "url": {
                  "raw": "{{baseUrl}}/v3/refunds/:refund_id",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "v3",
                    "refunds",
                    ":refund_id"
                  ],
                  "variable": [
                    {
                      "key": "refund_id",
                      "value": "5e1d7c3a-9b2f-4a6e-8d4c-0f3b2a1e9c87",
                      "description": "`id` возврата из ответа на его создание или из списка возвратов."
                    }
                  ]
                }
              },
              "status": "OK",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "cookie": [],
              "body": "{\n  \"id\": \"5e1d7c3a-9b2f-4a6e-8d4c-0f3b2a1e9c87\",\n  \"payment_id\": \"2f9b6c1e-4d7a-4c3b-9e8f-1a2b3c4d5e6f\",\n  \"status\": \"succeeded\",\n  \"created_at\": \"2026-10-19T09:40:12.305Z\",\n  \"amount\": {\n    \"value\": \"300.00\",\n    \"currency\": \"RUB\"\n  },\n  \"description\": \"Возврат по заказу №123\",\n  \"metadata\": {\n    \"order_id\": \"123\"\n  }\n}"
            }
          ]
        },
        {
          "name": "Список возвратов",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{baseUrl}}/v3/refunds?payment_id=c4a8e2f1-9b3d-4f6a-8e1c-7d2b5a9f3e60&limit=10",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v3",
                "refunds"
              ],
              "query": [
                {
                  "key": "payment_id",
                  "value": "c4a8e2f1-9b3d-4f6a-8e1c-7d2b5a9f3e60",
                  "description": "Только возвраты этого платежа: его `id`."
                },
                {
                  "key": "limit",
                  "value": "10",
                  "description": "Сколько возвратов на странице: от 1 до 100. По умолчанию 10."
                },
                {
                  "key": "cursor",
                  "value": "MjAyNi0xMC0xN1QxODozOTo1NS44NzFa",
                  "description": "Значение `next_cursor` из предыдущего ответа — чтобы получить следующую страницу. Передавайте как есть.",
                  "disabled": true
                },
                {
                  "key": "status",
                  "value": "succeeded",
                  "description": "Только возвраты с этим статусом: `pending`, `succeeded` или `canceled`.",
                  "disabled": true
                },
                {
                  "key": "created_at.gte",
                  "value": "2026-10-01T00:00:00.000Z",
                  "description": "Созданы в этот момент или позже. Указывается по [UTC](https://ru.wikipedia.org/wiki/%D0%92%D1%81%D0%B5%D0%BC%D0%B8%D1%80%D0%BD%D0%BE%D0%B5_%D0%BA%D0%BE%D0%BE%D1%80%D0%B4%D0%B8%D0%BD%D0%B8%D1%80%D0%BE%D0%B2%D0%B0%D0%BD%D0%BD%D0%BE%D0%B5_%D0%B2%D1%80%D0%B5%D0%BC%D1%8F) и передаётся в формате [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601). Пример: `2026-10-01T00:00:00.000Z`.",
                  "disabled": true
                },
                {
                  "key": "created_at.gt",
                  "value": "2026-10-01T00:00:00.000Z",
                  "description": "Созданы позже этого момента. Указывается по [UTC](https://ru.wikipedia.org/wiki/%D0%92%D1%81%D0%B5%D0%BC%D0%B8%D1%80%D0%BD%D0%BE%D0%B5_%D0%BA%D0%BE%D0%BE%D1%80%D0%B4%D0%B8%D0%BD%D0%B8%D1%80%D0%BE%D0%B2%D0%B0%D0%BD%D0%BD%D0%BE%D0%B5_%D0%B2%D1%80%D0%B5%D0%BC%D1%8F) и передаётся в формате [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601). Пример: `2026-10-01T00:00:00.000Z`.",
                  "disabled": true
                },
                {
                  "key": "created_at.lte",
                  "value": "2026-10-31T23:59:59.999Z",
                  "description": "Созданы в этот момент или раньше. Указывается по [UTC](https://ru.wikipedia.org/wiki/%D0%92%D1%81%D0%B5%D0%BC%D0%B8%D1%80%D0%BD%D0%BE%D0%B5_%D0%BA%D0%BE%D0%BE%D1%80%D0%B4%D0%B8%D0%BD%D0%B8%D1%80%D0%BE%D0%B2%D0%B0%D0%BD%D0%BD%D0%BE%D0%B5_%D0%B2%D1%80%D0%B5%D0%BC%D1%8F) и передаётся в формате [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601). Пример: `2026-10-31T23:59:59.999Z`.",
                  "disabled": true
                },
                {
                  "key": "created_at.lt",
                  "value": "2026-11-01T00:00:00.000Z",
                  "description": "Созданы раньше этого момента. Указывается по [UTC](https://ru.wikipedia.org/wiki/%D0%92%D1%81%D0%B5%D0%BC%D0%B8%D1%80%D0%BD%D0%BE%D0%B5_%D0%BA%D0%BE%D0%BE%D1%80%D0%B4%D0%B8%D0%BD%D0%B8%D1%80%D0%BE%D0%B2%D0%B0%D0%BD%D0%BD%D0%BE%D0%B5_%D0%B2%D1%80%D0%B5%D0%BC%D1%8F) и передаётся в формате [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601). Пример: `2026-11-01T00:00:00.000Z`.",
                  "disabled": true
                }
              ]
            },
            "description": "Возвращает возвраты вашего магазина от новых к старым: и созданные через API, и сделанные в личном кабинете. Можно отфильтровать по платежу, статусу и дате создания. Список отдаётся страницами. Заголовок `Idempotence-Key` этому методу не нужен. Тела у запроса нет.\n\nСправочник: https://avantpay.io/developers/api/#get_refunds_list"
          },
          "response": [
            {
              "name": "объект списка, последняя страница",
              "originalRequest": {
                "method": "GET",
                "header": [],
                "url": {
                  "raw": "{{baseUrl}}/v3/refunds?payment_id=c4a8e2f1-9b3d-4f6a-8e1c-7d2b5a9f3e60&limit=10",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "v3",
                    "refunds"
                  ],
                  "query": [
                    {
                      "key": "payment_id",
                      "value": "c4a8e2f1-9b3d-4f6a-8e1c-7d2b5a9f3e60",
                      "description": "Только возвраты этого платежа: его `id`."
                    },
                    {
                      "key": "limit",
                      "value": "10",
                      "description": "Сколько возвратов на странице: от 1 до 100. По умолчанию 10."
                    },
                    {
                      "key": "cursor",
                      "value": "MjAyNi0xMC0xN1QxODozOTo1NS44NzFa",
                      "description": "Значение `next_cursor` из предыдущего ответа — чтобы получить следующую страницу. Передавайте как есть.",
                      "disabled": true
                    },
                    {
                      "key": "status",
                      "value": "succeeded",
                      "description": "Только возвраты с этим статусом: `pending`, `succeeded` или `canceled`.",
                      "disabled": true
                    },
                    {
                      "key": "created_at.gte",
                      "value": "2026-10-01T00:00:00.000Z",
                      "description": "Созданы в этот момент или позже. Указывается по [UTC](https://ru.wikipedia.org/wiki/%D0%92%D1%81%D0%B5%D0%BC%D0%B8%D1%80%D0%BD%D0%BE%D0%B5_%D0%BA%D0%BE%D0%BE%D1%80%D0%B4%D0%B8%D0%BD%D0%B8%D1%80%D0%BE%D0%B2%D0%B0%D0%BD%D0%BD%D0%BE%D0%B5_%D0%B2%D1%80%D0%B5%D0%BC%D1%8F) и передаётся в формате [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601). Пример: `2026-10-01T00:00:00.000Z`.",
                      "disabled": true
                    },
                    {
                      "key": "created_at.gt",
                      "value": "2026-10-01T00:00:00.000Z",
                      "description": "Созданы позже этого момента. Указывается по [UTC](https://ru.wikipedia.org/wiki/%D0%92%D1%81%D0%B5%D0%BC%D0%B8%D1%80%D0%BD%D0%BE%D0%B5_%D0%BA%D0%BE%D0%BE%D1%80%D0%B4%D0%B8%D0%BD%D0%B8%D1%80%D0%BE%D0%B2%D0%B0%D0%BD%D0%BD%D0%BE%D0%B5_%D0%B2%D1%80%D0%B5%D0%BC%D1%8F) и передаётся в формате [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601). Пример: `2026-10-01T00:00:00.000Z`.",
                      "disabled": true
                    },
                    {
                      "key": "created_at.lte",
                      "value": "2026-10-31T23:59:59.999Z",
                      "description": "Созданы в этот момент или раньше. Указывается по [UTC](https://ru.wikipedia.org/wiki/%D0%92%D1%81%D0%B5%D0%BC%D0%B8%D1%80%D0%BD%D0%BE%D0%B5_%D0%BA%D0%BE%D0%BE%D1%80%D0%B4%D0%B8%D0%BD%D0%B8%D1%80%D0%BE%D0%B2%D0%B0%D0%BD%D0%BD%D0%BE%D0%B5_%D0%B2%D1%80%D0%B5%D0%BC%D1%8F) и передаётся в формате [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601). Пример: `2026-10-31T23:59:59.999Z`.",
                      "disabled": true
                    },
                    {
                      "key": "created_at.lt",
                      "value": "2026-11-01T00:00:00.000Z",
                      "description": "Созданы раньше этого момента. Указывается по [UTC](https://ru.wikipedia.org/wiki/%D0%92%D1%81%D0%B5%D0%BC%D0%B8%D1%80%D0%BD%D0%BE%D0%B5_%D0%BA%D0%BE%D0%BE%D1%80%D0%B4%D0%B8%D0%BD%D0%B8%D1%80%D0%BE%D0%B2%D0%B0%D0%BD%D0%BD%D0%BE%D0%B5_%D0%B2%D1%80%D0%B5%D0%BC%D1%8F) и передаётся в формате [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601). Пример: `2026-11-01T00:00:00.000Z`.",
                      "disabled": true
                    }
                  ]
                }
              },
              "status": "OK",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "cookie": [],
              "body": "{\n  \"type\": \"list\",\n  \"items\": [\n    {\n      \"id\": \"a3c9e7b1-2d4f-4e6a-9b8c-1f0e2d3c4b5a\",\n      \"payment_id\": \"c4a8e2f1-9b3d-4f6a-8e1c-7d2b5a9f3e60\",\n      \"status\": \"canceled\",\n      \"cancellation_details\": {\n        \"party\": \"avantpay\",\n        \"reason\": \"insufficient_funds\"\n      },\n      \"created_at\": \"2026-10-18T08:12:44.019Z\",\n      \"amount\": {\n        \"value\": \"100.00\",\n        \"currency\": \"RUB\"\n      },\n      \"metadata\": {}\n    },\n    {\n      \"id\": \"9d4b2e6f-1a3c-4d5e-8f7a-6b5c4d3e2f10\",\n      \"payment_id\": \"c4a8e2f1-9b3d-4f6a-8e1c-7d2b5a9f3e60\",\n      \"status\": \"succeeded\",\n      \"created_at\": \"2026-10-17T19:05:31.642Z\",\n      \"amount\": {\n        \"value\": \"50.00\",\n        \"currency\": \"RUB\"\n      },\n      \"description\": \"Возврат по заказу №122\",\n      \"metadata\": {\n        \"order_id\": \"122\"\n      }\n    }\n  ]\n}"
            }
          ]
        }
      ]
    }
  ]
}
