Reembolsos

Cost+ soporta tanto reembolsos totales como parciales en pedidos completados. Los reembolsos se procesan a traves del metodo de pago original utilizado en la transaccion.

Crear un reembolso

Envia una solicitud POST a /v1/orders/\{id\}/refunds/ para iniciar un reembolso en un pedido completado.

Solicitud

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

El campo amount esta en centimos. Para reembolsar 1,00 EUR, establece amount en 100. Para emitir un reembolso total, establece el importe igual al importe total del pedido.

Campos de la solicitud

Campo	Obligatorio	Descripcion
`amount`	Si	Importe del reembolso en centimos
`description`	No	Motivo del reembolso
`merchant_order_id`	No	Tu propio ID de referencia para el reembolso
`extra`	No	Metadatos adicionales como objeto clave-valor

Respuesta

La API devuelve el objeto de reembolso con su estado actual:

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

Campos de la respuesta

Campo	Descripcion
`id`	Identificador unico del reembolso
`created`	Marca de tiempo de cuando se creo el reembolso
`modified`	Marca de tiempo de la ultima actualizacion del reembolso
`amount`	Importe del reembolso en centimos
`currency`	Moneda del reembolso (coincide con la moneda del pedido)
`status`	Estado actual del reembolso (`pending`, `completed`, `failed`)
`description`	Motivo del reembolso
`merchant_order_id`	Tu ID de referencia
`extra`	Metadatos adicionales

Reembolsos totales vs. parciales

Reembolso total: Establece el amount igual al importe total del pedido. Se devuelve el pago completo al cliente.
Reembolso parcial: Establece el amount en un valor inferior al importe total del pedido. Solo se devuelve el importe especificado.

Puedes emitir multiples reembolsos parciales en el mismo pedido, siempre que el importe total reembolsado no exceda el importe original del pedido.

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

Los reembolsos solo pueden emitirse en pedidos con estado completed. Intentar reembolsar un pedido que aun no se ha completado resultara en un error.

Usa el campo merchant_order_id para vincular los reembolsos con tus sistemas internos. Esto es especialmente util cuando se emiten multiples reembolsos parciales en el mismo pedido.

Estados del reembolso

Estado	Descripcion
`pending`	El reembolso ha sido iniciado y esta siendo procesado.
`completed`	El reembolso se ha procesado correctamente. Los fondos seran devueltos al cliente.
`failed`	El reembolso no pudo ser procesado. Contacta con el soporte de Cost+ para asistencia.

El tiempo que tarda el importe reembolsado en aparecer en la cuenta del cliente depende del metodo de pago y del banco del cliente. Los reembolsos de tarjeta de credito normalmente tardan de 5 a 10 dias habiles.

Consultar el importe reembolsable

Antes de emitir un reembolso parcial, puedes consultar cuanto hay disponible:

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

El campo refundable en la respuesta muestra el importe maximo que puedes reembolsar.

Endpoints relacionados

Crear reembolso — emitir un reembolso total o parcial en un pedido completado
Listar reembolsos — obtener todos los reembolsos de un pedido

On this page