Visszatérítések

A Cost+ teljes és részleges visszatérítéseket is támogat a teljesített rendeléseken. A visszatérítések az eredeti fizetési módon keresztül kerülnek feldolgozásra.

Visszatérítés létrehozása

Küldjön egy POST kérést a /v1/orders/\{id\}/refunds/ végpontra egy teljesített rendelés visszatérítésének kezdeményezéséhez.

Kérés

{
  "amount": 100,
  "description": "Refund for item",
  "merchant_order_id": "refund-001"
}

Az amount mező centben van megadva. 1,00 EUR visszatérítéséhez állítsa az amount értékét 100-ra. Teljes visszatérítéshez állítsa az összeget a teljes rendelési összegre.

Kérés mezők

Mező	Kötelező	Leírás
`amount`	Igen	Visszatérítés összege centben
`description`	Nem	A visszatérítés oka
`merchant_order_id`	Nem	Az Ön saját referenciaazonosítója a visszatérítéshez
`extra`	Nem	További metaadatok kulcs-érték objektumként

Válasz

Az API a visszatérítés objektumot adja vissza az aktuális állapotával:

{
  "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
}

Válasz mezők

Mező	Leírás
`id`	A visszatérítés egyedi azonosítója
`created`	A visszatérítés létrehozásának időbélyege
`modified`	A visszatérítés utolsó módosításának időbélyege
`amount`	Visszatérítés összege centben
`currency`	A visszatérítés pénzneme (megegyezik a rendelés pénznemével)
`status`	Aktuális visszatérítési állapot (`pending`, `completed`, `failed`)
`description`	A visszatérítés oka
`merchant_order_id`	Az Ön referenciaazonosítója
`extra`	További metaadatok

Teljes és részleges visszatérítés

Teljes visszatérítés: Állítsa az amount értékét a teljes rendelési összegre. A teljes fizetés visszakerül az ügyfélhez.
Részleges visszatérítés: Állítsa az amount értékét a teljes rendelési összegnél kevesebbre. Csak a megadott összeg kerül visszatérítésre.

Több részleges visszatérítést is kiadhat ugyanazon rendelésre, amennyiben az összes visszatérített összeg nem haladja meg az eredeti rendelési összeget.

{
  "amount": 500,
  "description": "Partial refund - damaged item"
}

Visszatérítés csak completed állapotú rendeléseken lehetséges. Egy még nem teljesített rendelés visszatérítési kísérlete hibát eredményez.

Használja a merchant_order_id mezőt a visszatérítések belső rendszereihez való kapcsolásához. Ez különösen hasznos, ha több részleges visszatérítést ad ki ugyanazon rendelésre.

Visszatérítési állapotok

Állapot	Leírás
`pending`	A visszatérítés elindult és feldolgozás alatt áll.
`completed`	A visszatérítés sikeresen feldolgozásra került. Az összeg visszakerül az ügyfélhez.
`failed`	A visszatérítés nem dolgozható fel. Vegye fel a kapcsolatot a Cost+ ügyfélszolgálattal.

A visszatérített összeg ügyfél számláján való megjelenésének ideje a fizetési módtól és az ügyfél bankjától függ. A hitelkártyás visszatérítések általában 5-10 munkanapot vesznek igénybe.

Visszatéríthető összeg ellenőrzése

Részleges visszatérítés kiadása előtt ellenőrizheti a rendelkezésre álló összeget:

curl -u YOUR_API_KEY: \
  "https://api.costplus.online/v1/orders/{order_id}/?fields[]=amount_details"

A válaszban a refundable mező mutatja a maximálisan visszatéríthető összeget.

Kapcsolódó végpontok

Visszatérítés létrehozása — teljes vagy részleges visszatérítés kiadása teljesített rendelésen
Visszatérítések listázása — rendelés összes visszatérítésének lekérdezése

On this page