Vračila
Obdelava celotnih in delnih vračil
Cost+ podpira tako celotna kot delna vračila na dokončanih naročilih. Vračila so obdelana prek izvirne plačilne metode, uporabljene za transakcijo.
Ustvarjanje vračila
Pošljite zahtevo POST na /v1/orders/\{id\}/refunds/ za začetek vračila na dokončanem naročilu.
Zahteva
{
"amount": 100,
"description": "Refund for item",
"merchant_order_id": "refund-001"
}Polje amount uporablja manjšo enoto ISO 4217 valute. Za EUR vračilo 1,00 EUR pomeni nastavitev amount na 100. Za vračilo celotnega zneska uporabite celoten znesek naročila.
Polja zahteve
| Polje | Obvezno | Opis |
|---|---|---|
amount | ja | Znesek vračila v manjši enoti ISO 4217 valute |
description | Ne | Razlog za vračilo |
merchant_order_id | Ne | Vaša lastna referenčna oznaka za vračilo |
extra | Ne | Dodatni metapodatki kot objekt ključ-vrednost |
Odgovor
API vrne objekt vračila s trenutnim statusom:
{
"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
}Polja odgovora
| Polje | Opis |
|---|---|
id | Edinstveni identifikator vračila |
created | Časovni žig ustvarjanja vračila |
modified | Časovni žig zadnje posodobitve vračila |
amount | Znesek vračila v manjši enoti ISO 4217 valute |
currency | Valuta vračila (ujema se z valuto naročila) |
status | Trenutni status vračila (pending, completed, failed) |
description | Razlog za vračilo |
merchant_order_id | Vaša referenčna oznaka |
extra | Dodatni metapodatki |
Celotna in delna vračila
- Celotno vračilo: Nastavite
amountna celoten znesek naročila. Celotno plačilo je vrnjeno stranki. - Delno vračilo: Nastavite
amountna manj kot celoten znesek naročila. Vrnjen je samo navedeni znesek.
Na istem naročilu lahko izdate več delnih vračil, dokler skupni vrnjeni znesek ne preseže izvirnega zneska naročila.
{
"amount": 500,
"description": "Partial refund - damaged item"
}Vračila je mogoče izdati samo na naročilih s statusom completed. Poskus vračila na naročilu, ki še ni dokončano, bo povzročil napako.
Uporabite polje merchant_order_id za povezovanje vračil z vašimi internimi sistemi. To je še posebej koristno pri izdaji več delnih vračil na istem naročilu.
Statusi vračil
| Status | Opis |
|---|---|
pending | Vračilo je bilo začeto in se obdeluje. |
completed | Vračilo je bilo uspešno obdelano. Sredstva bodo vrnjena stranki. |
failed | Vračila ni bilo mogoče obdelati. Obrnite se na podporo Cost+ za pomoč. |
Čas, potreben za prikaz vrnjenega zneska na računu stranke, je odvisen od plačilne metode in banke stranke. Vračila kreditnih kartic običajno trajajo 5-10 delovnih dni.
Preverjanje razpoložljivega zneska za vračilo
Pred izdajo delnega vračila lahko preverite, koliko je na voljo:
curl -u YOUR_API_KEY: \
"https://api.costplus.online/v1/orders/{order_id}/?fields[]=amount_details"Polje refundable v odgovoru prikazuje največji znesek, ki ga lahko vrnete.
Povezane končne točke
- Ustvari vračilo — izdajte celotno ali delno vračilo na dokončanem naročilu
- Seznam vračil — pridobite vsa vračila za naročilo