Cost+Docs

Povrati

Obradite potpune i djelomične povrate

Cost+ podržava potpune i djelomične povrate na dovršenim narudžbama. Povrati se obrađuju putem izvornog načina plaćanja korištenog za transakciju.

Stvaranje povrata

Pošaljite POST zahtjev na /v1/orders/\{id\}/refunds/ za pokretanje povrata na dovršenoj narudžbi.

Zahtjev

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

Polje amount koristi sporednu jedinicu valute ISO 4217. Za EUR, povrat 1,00 EUR znači postavljanje amount na 100. Za izdavanje punog povrata novca upotrijebite puni iznos narudžbe.

Polja zahtjeva

PoljeObaveznoOpis
amountDaIznos povrata u manjoj jedinici ISO 4217 valute
descriptionNeRazlog povrata
merchant_order_idNeVaš vlastiti referentni ID za povrat
extraNeDodatni metapodaci kao objekt ključ-vrijednost

Odgovor

API vraća objekt povrata 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
idJedinstveni identifikator povrata
createdVremenska oznaka kada je povrat stvoren
modifiedVremenska oznaka kada je povrat zadnji put ažuriran
amountIznos povrata u manjoj jedinici ISO 4217 valute
currencyValuta povrata (odgovara valuti narudžbe)
statusTrenutni status povrata (pending, completed, failed)
descriptionRazlog povrata
merchant_order_idVaš referentni ID
extraDodatni metapodaci

Potpuni naspram djelomičnih povrata

  • Potpuni povrat: Postavite amount na ukupni iznos narudžbe. Cijelo plaćanje vraća se kupcu.
  • Djelomični povrat: Postavite amount na manje od ukupnog iznosa narudžbe. Samo navedeni iznos se vraća.

Možete izdati više djelomičnih povrata na istoj narudžbi, sve dok ukupni vraćeni iznos ne premašuje izvorni iznos narudžbe.

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

Povrati se mogu izdati samo na narudžbama sa statusom completed. Pokušaj povrata na narudžbi koja još nije dovršena rezultirat će greškom.

Koristite polje merchant_order_id za povezivanje povrata s vašim internim sustavima. Ovo je posebno korisno pri izdavanju više djelomičnih povrata na istoj narudžbi.

Statusi povrata

StatusOpis
pendingPovrat je pokrenut i obrađuje se.
completedPovrat je uspješno obrađen. Sredstva će biti vraćena kupcu.
failedPovrat nije mogao biti obrađen. Kontaktirajte Cost+ podršku za pomoć.

Vrijeme potrebno da se vraćeni iznos pojavi na računu kupca ovisi o načinu plaćanja i banci kupca. Povrati kreditnih kartica obično traju 5-10 radnih dana.

Provjera iznosa dostupnog za povrat

Prije izdavanja djelomičnog povrata, možete provjeriti koliko je dostupno:

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

Polje refundable u odgovoru prikazuje maksimalni iznos koji možete vratiti.

Povezane krajnje točke

  • Stvori povrat — izdajte potpuni ili djelomični povrat na dovršenoj narudžbi
  • Popis povrata — dohvatite sve povrate za narudžbu

On this page