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
| Polje | Obavezno | Opis |
|---|---|---|
amount | Da | Iznos povrata u manjoj jedinici ISO 4217 valute |
description | Ne | Razlog povrata |
merchant_order_id | Ne | Vaš vlastiti referentni ID za povrat |
extra | Ne | Dodatni 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
| Polje | Opis |
|---|---|
id | Jedinstveni identifikator povrata |
created | Vremenska oznaka kada je povrat stvoren |
modified | Vremenska oznaka kada je povrat zadnji put ažuriran |
amount | Iznos povrata u manjoj jedinici ISO 4217 valute |
currency | Valuta povrata (odgovara valuti narudžbe) |
status | Trenutni status povrata (pending, completed, failed) |
description | Razlog povrata |
merchant_order_id | Vaš referentni ID |
extra | Dodatni metapodaci |
Potpuni naspram djelomičnih povrata
- Potpuni povrat: Postavite
amountna ukupni iznos narudžbe. Cijelo plaćanje vraća se kupcu. - Djelomični povrat: Postavite
amountna 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
| Status | Opis |
|---|---|
pending | Povrat je pokrenut i obrađuje se. |
completed | Povrat je uspješno obrađen. Sredstva će biti vraćena kupcu. |
failed | Povrat 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