Palautukset

Cost+ tukee sekä täysiä että osittaisia palautuksia valmiille tilauksille. Palautukset käsitellään alkuperäisen tapahtumassa käytetyn maksutavan kautta.

Palautuksen luominen

Lähetä POST-pyyntö osoitteeseen /v1/orders/\{id\}/refunds/ aloittaaksesi palautuksen valmiille tilaukselle.

Pyyntö

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

amount-kenttä on senteissä. Palauttaaksesi 1,00 EUR, aseta amount arvoon 100. Täyden palautuksen tekemiseksi aseta summa tilauksen koko summaksi.

Pyyntökentät

Kenttä	Pakollinen	Kuvaus
`amount`	Kyllä	Palautussumma senteissä
`description`	Ei	Palautuksen syy
`merchant_order_id`	Ei	Oma viitetunnisteesi palautukselle
`extra`	Ei	Lisämetatiedot avain-arvo-objektina

Vastaus

API palauttaa palautusobjektin ja sen nykyisen tilan:

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

Vastauskentät

Kenttä	Kuvaus
`id`	Palautuksen yksilöllinen tunniste
`created`	Aikaleima palautuksen luomisesta
`modified`	Aikaleima palautuksen viimeisimmästä päivityksestä
`amount`	Palautussumma senteissä
`currency`	Palautuksen valuutta (vastaa tilauksen valuuttaa)
`status`	Palautuksen nykyinen tila (`pending`, `completed`, `failed`)
`description`	Palautuksen syy
`merchant_order_id`	Oma viitetunnisteesi
`extra`	Lisämetatiedot

Täysi vs. osittainen palautus

Täysi palautus: Aseta amount tilauksen kokonaissummaksi. Koko maksu palautetaan asiakkaalle.
Osittainen palautus: Aseta amount tilauksen kokonaissummaa pienemmäksi. Vain määritetty summa palautetaan.

Voit tehdä useita osittaisia palautuksia samalle tilaukselle, kunhan palautettu kokonaissumma ei ylitä alkuperäisen tilauksen summaa.

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

Palautuksia voi tehdä vain tilauksille, joiden tila on completed. Palautuksen yrittäminen keskeneräiselle tilaukselle johtaa virheeseen.

Käytä merchant_order_id-kenttää yhdistääksesi palautukset sisäisiin järjestelmiisi. Tämä on erityisen hyödyllistä, kun teet useita osittaisia palautuksia samalle tilaukselle.

Palautusten tilat

Tila	Kuvaus
`pending`	Palautus on aloitettu ja sitä käsitellään.
`completed`	Palautus on käsitelty onnistuneesti. Varat palautetaan asiakkaalle.
`failed`	Palautusta ei voitu käsitellä. Ota yhteyttä Cost+-tukeen avun saamiseksi.

Aika, joka kuluu palautetun summan näkymiseen asiakkaan tilillä, riippuu maksutavasta ja asiakkaan pankista. Luottokorttien palautukset kestävät tyypillisesti 5–10 arkipäivää.

Palautettavissa olevan summan tarkistaminen

Ennen osittaisen palautuksen tekemistä voit tarkistaa käytettävissä olevan summan:

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

Vastauksen refundable-kenttä näyttää enimmäissumman, jonka voit palauttaa.

Liittyvät päätepisteet

Luo palautus — tee täysi tai osittainen palautus valmiille tilaukselle
Listaa palautukset — hae kaikki tilauksen palautukset

On this page