Възстановявания
Обработвайте пълни и частични възстановявания
Cost+ поддържа както пълни, така и частични възстановявания на завършени поръчки. Възстановяванията се обработват чрез оригиналния метод на плащане, използван за транзакцията.
Създаване на възстановяване
Изпратете POST заявка към /v1/orders/\{id\}/refunds/, за да инициирате възстановяване на завършена поръчка.
Заявка
{
"amount": 100,
"description": "Refund for item",
"merchant_order_id": "refund-001"
}Полето amount използва второстепенната единица ISO 4217 на валутата. За EUR възстановяването на 1,00 EUR означава задаване на amount на 100. За пълно възстановяване на сумата използвайте пълната сума на поръчката.
Полета на заявката
| Поле | Задължително | Описание |
|---|---|---|
amount | да | Сумата за възстановяване във валутната единица ISO 4217 |
description | Не | Причина за възстановяването |
merchant_order_id | Не | Ваш собствен референтен идентификатор за възстановяването |
extra | Не | Допълнителни метаданни като обект ключ-стойност |
Отговор
API-то връща обекта на възстановяването с текущия му статус:
{
"id": "ref_abc123...",
"created": "2024-01-02T10:00:00.000000+00:00",
"modified": "2024-01-02T10:00:00.000000+00:00",
"amount": 100,
"currency": "EUR",
"status": "pending",
"description": "Refund for item",
"merchant_order_id": "refund-001",
"extra": null
}Полета на отговора
| Поле | Описание |
|---|---|
id | Уникален идентификатор на възстановяването |
created | Времева марка на създаване на възстановяването |
modified | Времева марка на последна актуализация на възстановяването |
amount | Сумата за възстановяване във валутната единица ISO 4217 |
currency | Валута на възстановяването (съвпада с валутата на поръчката) |
status | Текущ статус на възстановяването (pending, completed, failed) |
description | Причина за възстановяването |
merchant_order_id | Вашият референтен идентификатор |
extra | Допълнителни метаданни |
Пълно срещу частично възстановяване
- Пълно възстановяване: Задайте
amountравна на общата сума на поръчката. Цялото плащане се връща на клиента. - Частично възстановяване: Задайте
amountпо-малка от общата сума на поръчката. Само посочената сума се връща.
Можете да издавате множество частични възстановявания на една и съща поръчка, стига общата възстановена сума да не надвишава първоначалната сума на поръчката.
{
"amount": 500,
"description": "Partial refund - damaged item"
}Възстановявания могат да се издават само за поръчки със статус completed. Опитът за възстановяване на поръчка, която все още не е завършена, ще доведе до грешка.
Използвайте полето merchant_order_id, за да свържете възстановяванията обратно към вътрешните си системи. Това е особено полезно при издаване на множество частични възстановявания на една и съща поръчка.
Статуси на възстановяване
| Статус | Описание |
|---|---|
pending | Възстановяването е инициирано и се обработва. |
completed | Възстановяването е успешно обработено. Средствата ще бъдат върнати на клиента. |
failed | Възстановяването не може да бъде обработено. Свържете се с поддръжката на Cost+ за съдействие. |
Времето, необходимо за появата на възстановената сума в сметката на клиента, зависи от метода на плащане и банката на клиента. Възстановяванията по кредитни карти обикновено отнемат 5-10 работни дни.
Проверка на сумата за възстановяване
Преди да издадете частично възстановяване, можете да проверите колко е налично:
curl -u YOUR_API_KEY: \
"https://api.costplus.online/v1/orders/{order_id}/?fields[]=amount_details"Полето refundable в отговора показва максималната сума, която можете да възстановите.
Свързани крайни точки
- Създаване на възстановяване — издайте пълно или частично възстановяване на завършена поръчка
- Списък с възстановявания — извлечете всички възстановявания за поръчка