Refusjoner

Cost+ støtter både fulle og delvise refusjoner på fullførte ordrer. Refusjoner behandles gjennom den opprinnelige betalingsmetoden som ble brukt for transaksjonen.

Opprette en refusjon

Send en POST-forespørsel til /v1/orders/\{id\}/refunds/ for å starte en refusjon på en fullført ordre.

Forespørsel

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

amount-feltet er i øre/cent. For å refundere 1,00 EUR, sett amount til 100. For å utstede en full refusjon, sett beløpet til det fulle ordrebeløpet.

Forespørselsfelt

Felt	Påkrevd	Beskrivelse
`amount`	Ja	Refusjonsbeløp i øre/cent
`description`	Nei	Årsak for refusjonen
`merchant_order_id`	Nei	Din egen referanse-ID for refusjonen
`extra`	Nei	Ekstra metadata som et nøkkelverdi-objekt

Svar

API-et returnerer refusjonsobjektet med gjeldende status:

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

Svarfelt

Felt	Beskrivelse
`id`	Unik identifikator for refusjonen
`created`	Tidsstempel for når refusjonen ble opprettet
`modified`	Tidsstempel for når refusjonen sist ble oppdatert
`amount`	Refusjonsbeløp i øre/cent
`currency`	Valuta for refusjonen (samsvarer med ordrevalutaen)
`status`	Gjeldende refusjonsstatus (`pending`, `completed`, `failed`)
`description`	Årsak for refusjonen
`merchant_order_id`	Din referanse-ID
`extra`	Ekstra metadata

Full kontra delvis refusjon

Full refusjon: Sett amount til det totale ordrebeløpet. Hele betalingen returneres til kunden.
Delvis refusjon: Sett amount til mindre enn det totale ordrebeløpet. Kun det angitte beløpet returneres.

Du kan utstede flere delvise refusjoner på samme ordre, så lenge det totale refunderte beløpet ikke overskrider det opprinnelige ordrebeløpet.

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

Refusjoner kan kun utstedes på ordrer med completed-status. Forsøk på å refundere en ordre som ikke er fullført vil resultere i en feil.

Bruk merchant_order_id-feltet for å koble refusjoner tilbake til dine interne systemer. Dette er spesielt nyttig ved utstedelse av flere delvise refusjoner på samme ordre.

Refusjonsstatuser

Status	Beskrivelse
`pending`	Refusjonen er startet og behandles.
`completed`	Refusjonen er behandlet. Midlene vil bli returnert til kunden.
`failed`	Refusjonen kunne ikke behandles. Kontakt Cost+ kundeservice for hjelp.

Tiden det tar før det refunderte beløpet vises på kundens konto avhenger av betalingsmetoden og kundens bank. Kredittkortrefusjoner tar vanligvis 5–10 virkedager.

Sjekke refunderbart beløp

Før du utsteder en delvis refusjon, kan du sjekke hvor mye som er tilgjengelig:

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

refundable-feltet i svaret viser det maksimale beløpet du kan refundere.

Relaterte endepunkter

Opprett refusjon — utsted en full eller delvis refusjon på en fullført ordre
List refusjoner — hent alle refusjoner for en ordre

On this page