Grąžinimai

Cost+ palaiko tiek pilnus, tiek dalinius grąžinimus užbaigtiems užsakymams. Grąžinimai apdorojami per originalų mokėjimo būdą, naudotą operacijai.

Grąžinimo kūrimas

Siųskite POST užklausą į /v1/orders/\{id\}/refunds/, kad inicijuotumėte grąžinimą užbaigtam užsakymui.

Užklausa

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

Lauke amount naudojamas mažiausias valiutos vienetas ISO 4217. Jei naudojate EUR, grąžinus 1,00 EUR, amount nustatoma į 100. Norėdami grąžinti visas lėšas, naudokite visą užsakymo sumą.

Užklausos laukai

Laukas	Privalomas	Aprašymas
`amount`	Taip	Grąžinama suma mažuoju valiutos vienetu ISO 4217
`description`	Ne	Grąžinimo priežastis
`merchant_order_id`	Ne	Jūsų nuosavasis grąžinimo nuorodos ID
`extra`	Ne	Papildomi metaduomenys kaip rakto-reikšmės objektas

Atsakymas

API grąžina grąžinimo objektą su esama būsena:

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

Atsakymo laukai

Laukas	Aprašymas
`id`	Unikalus grąžinimo identifikatorius
`created`	Laiko žyma, kada grąžinimas buvo sukurtas
`modified`	Laiko žyma, kada grąžinimas buvo paskutinį kartą atnaujintas
`amount`	Grąžinama suma mažuoju valiutos vienetu ISO 4217
`currency`	Grąžinimo valiuta (atitinka užsakymo valiutą)
`status`	Esama grąžinimo būsena (`pending`, `completed`, `failed`)
`description`	Grąžinimo priežastis
`merchant_order_id`	Jūsų nuorodos ID
`extra`	Papildomi metaduomenys

Pilni ir daliniai grąžinimai

Pilnas grąžinimas: nustatykite amount kaip pilną užsakymo sumą. Visa mokėjimo suma grąžinama klientui.
Dalinis grąžinimas: nustatykite amount mažiau nei pilna užsakymo suma. Grąžinama tik nurodyta suma.

Galite atlikti kelis dalinius grąžinimus tam pačiam užsakymui, jei bendra grąžinta suma neviršija pradinės užsakymo sumos.

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

Grąžinimus galima atlikti tik užsakymams su completed būsena. Bandant grąžinti dar neužbaigtą užsakymą, bus klaida.

Naudokite merchant_order_id lauką, kad susietumėte grąžinimus su savo vidinėmis sistemomis. Tai ypač naudinga atliekant kelis dalinius grąžinimus tam pačiam užsakymui.

Grąžinimo būsenos

Būsena	Aprašymas
`pending`	Grąžinimas inicijuotas ir apdorojamas.
`completed`	Grąžinimas sėkmingai apdorotas. Lėšos bus grąžintos klientui.
`failed`	Grąžinimo nepavyko apdoroti. Susisiekite su Cost+ palaikymu.

Laikas, per kurį grąžinta suma atsiras kliento sąskaitoje, priklauso nuo mokėjimo būdo ir kliento banko. Kreditinės kortelės grąžinimai paprastai trunka 5–10 darbo dienų.

Grąžintinos sumos tikrinimas

Prieš atliekant dalinį grąžinimą, galite patikrinti, kiek galima grąžinti:

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

Lauke refundable atsakyme rodoma maksimali suma, kurią galite grąžinti.

Susiję galiniai taškai

Sukurti grąžinimą — atlikti pilną arba dalinį grąžinimą užbaigtam užsakymui
Grąžinimų sąrašas — gauti visus užsakymo grąžinimus

Grąžinimai

On this page