Terugbetalingen

Cost+ ondersteunt zowel volledige als gedeeltelijke terugbetalingen op voltooide bestellingen. Terugbetalingen worden verwerkt via de oorspronkelijke betaalmethode die voor de transactie is gebruikt.

Een terugbetaling aanmaken

Stuur een POST-verzoek naar /v1/orders/\{id\}/refunds/ om een terugbetaling te initieren op een voltooide bestelling.

Verzoek

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

Het veld amount is in centen. Om 1,00 EUR terug te betalen, stelt u amount in op 100. Voor een volledige terugbetaling stelt u het bedrag in op het volledige bestellingsbedrag.

Verzoeksvelden

Veld	Vereist	Beschrijving
`amount`	Ja	Terugbetalingsbedrag in centen
`description`	Nee	Reden voor de terugbetaling
`merchant_order_id`	Nee	Uw eigen referentie-ID voor de terugbetaling
`extra`	Nee	Aanvullende metadata als een sleutel-waarde-object

Respons

De API retourneert het terugbetalingsobject met de huidige 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
}

Responsvelden

Veld	Beschrijving
`id`	Unieke identificatie voor de terugbetaling
`created`	Tijdstempel van aanmaak van de terugbetaling
`modified`	Tijdstempel van de laatste wijziging van de terugbetaling
`amount`	Terugbetalingsbedrag in centen
`currency`	Valuta van de terugbetaling (komt overeen met de bestellingsvaluta)
`status`	Huidige terugbetalingsstatus (`pending`, `completed`, `failed`)
`description`	Reden voor de terugbetaling
`merchant_order_id`	Uw referentie-ID
`extra`	Aanvullende metadata

Volledige vs. gedeeltelijke terugbetalingen

Volledige terugbetaling: Stel het amount in op het totale bestellingsbedrag. De volledige betaling wordt teruggestort aan de klant.
Gedeeltelijke terugbetaling: Stel het amount in op minder dan het totale bestellingsbedrag. Alleen het opgegeven bedrag wordt teruggestort.

U kunt meerdere gedeeltelijke terugbetalingen uitvoeren op dezelfde bestelling, zolang het totaal terugbetaalde bedrag het oorspronkelijke bestellingsbedrag niet overschrijdt.

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

Terugbetalingen kunnen alleen worden uitgevoerd op bestellingen met de status completed. Een poging om een bestelling terug te betalen die nog niet is voltooid, resulteert in een fout.

Gebruik het veld merchant_order_id om terugbetalingen te koppelen aan uw interne systemen. Dit is vooral handig bij het uitvoeren van meerdere gedeeltelijke terugbetalingen op dezelfde bestelling.

Terugbetalingsstatussen

Status	Beschrijving
`pending`	De terugbetaling is geinitieerd en wordt verwerkt.
`completed`	De terugbetaling is succesvol verwerkt. Het bedrag wordt teruggestort aan de klant.
`failed`	De terugbetaling kon niet worden verwerkt. Neem contact op met Cost+ support voor hulp.

De tijd die nodig is voordat het terugbetaalde bedrag op de rekening van de klant verschijnt, is afhankelijk van de betaalmethode en de bank van de klant. Terugbetalingen per creditcard duren doorgaans 5-10 werkdagen.

Terugbetaalbaar bedrag controleren

Voordat u een gedeeltelijke terugbetaling uitvoert, kunt u controleren hoeveel beschikbaar is:

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

Het veld refundable in de respons toont het maximale bedrag dat u kunt terugbetalen.

Gerelateerde eindpunten

Terugbetaling aanmaken — een volledige of gedeeltelijke terugbetaling uitvoeren op een voltooide bestelling
Terugbetalingen weergeven — alle terugbetalingen voor een bestelling ophalen

On this page