Refusioner

Cost+ understøtter både fulde og delvise refusioner på gennemførte ordrer. Refusioner behandles via den oprindelige betalingsmetode, der blev brugt til transaktionen.

Oprettelse af en refusion

Send en POST-anmodning til /v1/orders/\{id\}/refunds/ for at igangsætte en refusion på en gennemført ordre.

Anmodning

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

Feltet amount er i øre/cent. For at tilbagebetale 1,00 EUR skal du sætte amount til 100. For at udstede en fuld refusion skal du sætte beløbet til det fulde ordrebeløb.

Anmodningsfelter

Felt	Påkrævet	Beskrivelse
`amount`	Ja	Refusionsbeløb i øre/cent
`description`	Nej	Årsag til refusionen
`merchant_order_id`	Nej	Dit eget reference-ID for refusionen
`extra`	Nej	Yderligere metadata som et nøgle-værdi-objekt

Svar

API'et returnerer refusionsobjektet med dens aktuelle 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
}

Svarfelter

Felt	Beskrivelse
`id`	Unik identifikator for refusionen
`created`	Tidsstempel for oprettelse af refusionen
`modified`	Tidsstempel for seneste opdatering af refusionen
`amount`	Refusionsbeløb i øre/cent
`currency`	Refusionens valuta (svarer til ordrevalutaen)
`status`	Aktuel refusionsstatus (`pending`, `completed`, `failed`)
`description`	Årsag til refusionen
`merchant_order_id`	Dit reference-ID
`extra`	Yderligere metadata

Fuld vs. delvis refusion

Fuld refusion: Sæt amount til det samlede ordrebeløb. Hele betalingen returneres til kunden.
Delvis refusion: Sæt amount til mindre end det samlede ordrebeløb. Kun det angivne beløb returneres.

Du kan udstede flere delvise refusioner på den samme ordre, så længe det samlede refunderede beløb ikke overstiger det oprindelige ordrebeløb.

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

Refusioner kan kun udstedes på ordrer med status completed. Forsøg på at refundere en ordre, der endnu ikke er gennemført, vil resultere i en fejl.

Brug feltet merchant_order_id til at koble refusioner tilbage til dine interne systemer. Dette er især nyttigt, når du udsteder flere delvise refusioner på den samme ordre.

Refusionsstatusser

Status	Beskrivelse
`pending`	Refusionen er igangsat og er under behandling.
`completed`	Refusionen er behandlet. Midlerne vil blive returneret til kunden.
`failed`	Refusionen kunne ikke behandles. Kontakt Cost+ support for assistance.

Tiden det tager for det refunderede beløb at blive vist på kundens konto afhænger af betalingsmetoden og kundens bank. Kreditkortrefusioner tager typisk 5-10 hverdage.

Kontrol af refunderbart beløb

Inden du udsteder en delvis refusion, kan du kontrollere, hvor meget der er tilgængeligt:

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

Feltet refundable i svaret viser det maksimale beløb, du kan refundere.

Relaterede endpoints

Opret refusion — udsted en fuld eller delvis refusion på en gennemført ordre
List refusioner — hent alle refusioner for en ordre

On this page