Reembolsa un pago o gestiona un contracargo

Qué puedes reembolsar

No se admiten reembolsos parciales. Suscribe tu endpoint de webhook a payment.reversed, payment.chargeback y payment.chargeback_closed.

Pasos: reversa un pago de Débito Inmediato (C2P)

1. 01
   Revisa el pago

   GET /v1/payments/:id debe mostrar un pago C2P COMPLETED que no se haya reversado antes.

2. 02
   Revérsalo

   POST /v1/payments/:id/reverse (hasta 5 por hora). Si el banco lo rechaza, recibes un 400 con su mensaje y nada cambia.

3. 03
   Confirma

   El pago pasa a REVERSED y llega payment.reversed con reversalType: "reversal". El monto completo sale de tu saldo y la comisión de VEXPay se devuelve. En un pago dividido, también se deshace la parte del vendedor.

curl --request POST "${API_URL}/v1/payments/PAYMENT_ID/reverse" \
  --header "x-api-key: ${VEXPAY_API_KEY}"

Pasos: reembolsa un pago en pesos

1. 01
   Mantén suficientes pesos

   Tu saldo COP (disponible más retenido) debe cubrir el neto que se acreditó. Los pesos que ya convertiste o retiraste no cuentan.

2. 02
   Reembólsalo

   POST /v1/cop/payments/:id/refund dentro de 96 horas desde que se completó.

3. 03
   Confirma

   El pago muestra refunded y llega payment.reversed con status: "refunded". La comisión COP se devuelve.

Qué pasa con un contracargo de tarjeta

1. 01
   El comprador disputa el cargo

   VEXPay registra el contracargo en el pago y lo debita de tu saldo en bolívares (la comisión original de la tarjeta no se devuelve). Si el banco cobra una comisión por contracargo, VEXPay te traslada exactamente ese monto como un movimiento aparte (feeVes, muchas veces 0), sin agregar nada. Recibes payment.chargeback; un contracargo total también envía payment.reversed con reversalType: "chargeback".

2. 02
   Regístralo

   GET /v1/payments/:id lista chargebacks[], y los movimientos aparecen en GET /v1/balance/transactions?paymentId=…. Registra cada uno una sola vez con los ledgerEntryIds del webhook.

3. 03
   VEXPay lo disputa

   Cuando se decide recibes payment.chargeback_closed con outcome. Ganado: el monto y la comisión de contracargo, si la hubo, vuelven (retenidos 24 horas) y el pago regresa a COMPLETED. Perdido: no se mueve nada más.

Comprueba que funcionó

• En Test, paga con la tarjeta 4000000000000259: cerca de un minuto después llega un contracargo de prueba con livemode: false.
• El reverso, reembolso o contracargo aparece en Portal → Balance movements y el pago muestra su nuevo estado en Payments.

Si algo sale mal

Relacionado: Consulta y reverso · Concilia tu saldo · Colombia (COP) · VPOS