Cost+Docs

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

PoljeObveznoOpis
amountjaZnesek vračila v manjši enoti ISO 4217 valute
descriptionNeRazlog za vračilo
merchant_order_idNeVaša lastna referenčna oznaka za vračilo
extraNeDodatni 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

PoljeOpis
idEdinstveni identifikator vračila
createdČasovni žig ustvarjanja vračila
modifiedČasovni žig zadnje posodobitve vračila
amountZnesek vračila v manjši enoti ISO 4217 valute
currencyValuta vračila (ujema se z valuto naročila)
statusTrenutni status vračila (pending, completed, failed)
descriptionRazlog za vračilo
merchant_order_idVaša referenčna oznaka
extraDodatni metapodatki

Celotna in delna vračila

  • Celotno vračilo: Nastavite amount na celoten znesek naročila. Celotno plačilo je vrnjeno stranki.
  • Delno vračilo: Nastavite amount na 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

StatusOpis
pendingVračilo je bilo začeto in se obdeluje.
completedVračilo je bilo uspešno obdelano. Sredstva bodo vrnjena stranki.
failedVrač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

On this page