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

Laukas amount nurodomas centais. Norint grąžinti 1,00 EUR, nustatykite amount kaip 100. Norint atlikti pilną grąžinimą, nustatykite sumą kaip pilną užsakymo sumą.

Užklausos laukai

Laukas	Privalomas	Aprašymas
`amount`	Taip	Grąžinimo suma centais
`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ąžinimo suma centais
`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

On this page