Endurgreiðslur

Cost+ styður bæði fullar og hluta endurgreiðslur á loknum pöntunum. Endurgreiðslur eru unnar gegnum upprunalega greiðslumátann sem notaður var fyrir færsluna.

Stofnun endurgreiðslu

Sendu POST-beiðni á /v1/orders/\{id\}/refunds/ til að hefja endurgreiðslu á lokinni pöntun.

Beiðni

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

amount reiturinn er í sentum. Til að endurgreiða 1,00 EUR, stilltu amount á 100. Til að gefa út fulla endurgreiðslu, stilltu upphæðina á fulla upphæð pöntunar.

Reitir beiðni

Reitur	Nauðsynlegur	Lýsing
`amount`	Já	Upphæð endurgreiðslu í sentum
`description`	Nei	Ástæða endurgreiðslu
`merchant_order_id`	Nei	Eigin tilvísunarnúmer þitt fyrir endurgreiðsluna
`extra`	Nei	Viðbótarlýsigögn sem lykil-gildi hlutur

Svar

API skilar endurgreiðsluhlut með núverandi stöðu:

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

Reitir svars

Reitur	Lýsing
`id`	Einstakt auðkenni endurgreiðslunnar
`created`	Tímastimpill stofnunar endurgreiðslunnar
`modified`	Tímastimpill síðustu uppfærslu endurgreiðslunnar
`amount`	Upphæð endurgreiðslu í sentum
`currency`	Gjaldmiðill endurgreiðslu (samsvarar gjaldmiðli pöntunar)
`status`	Núverandi staða endurgreiðslu (`pending`, `completed`, `failed`)
`description`	Ástæða endurgreiðslu
`merchant_order_id`	Tilvísunarnúmerið þitt
`extra`	Viðbótarlýsigögn

Fullar og hluta endurgreiðslur

Full endurgreiðsla: Stilltu amount á fulla upphæð pöntunar. Öll greiðslan er skilað til viðskiptavinar.
Hluta endurgreiðsla: Stilltu amount á minna en fulla upphæð pöntunar. Aðeins tilgreind upphæð er skilað.

Þú getur gefið út margar hluta endurgreiðslur á sömu pöntun, svo framarlega sem heildar endurgreidd upphæð fer ekki yfir upprunalega upphæð pöntunar.

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

Aðeins er hægt að gefa út endurgreiðslur á pöntunum með stöðuna completed. Tilraun til endurgreiðslu á pöntun sem er ekki enn lokin mun leiða til villu.

Notaðu merchant_order_id reitinn til að tengja endurgreiðslur aftur við innri kerfin þín. Þetta er sérstaklega gagnlegt þegar margar hluta endurgreiðslur eru gefnar út á sömu pöntun.

Stöður endurgreiðslu

Staða	Lýsing
`pending`	Endurgreiðslan hefur verið hafin og er í vinnslu.
`completed`	Endurgreiðslan hefur verið unnin. Fjármunir verða skilaðir til viðskiptavinar.
`failed`	Ekki var hægt að vinna úr endurgreiðslunni. Hafðu samband við Cost+ þjónustu.

Tíminn sem tekur endurgreidda upphæð að birtast á reikningi viðskiptavinar fer eftir greiðslumáta og banka viðskiptavinar. Endurgreiðslur kreditkorta taka venjulega 5-10 virka daga.

Athugun endurgreiðanlegrar upphæðar

Áður en hluta endurgreiðsla er gefin út geturðu athugað hversu mikið er í boði:

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

refundable reiturinn í svarinu sýnir hámarksupphæðina sem þú getur endurgreitt.

Tengdir endapunktar

Stofna endurgreiðslu — gefðu út fulla eða hluta endurgreiðslu á lokinni pöntun
Listi endurgreiðslna — sæktu allar endurgreiðslur fyrir pöntun

On this page