Consulta y reversa pagos
Concilia por el ID del gateway o la referencia de correlación, y reversa pagos C2P elegibles.
Consulta de pagos
curl "${API_URL}/v1/payments/PAYMENT_ID" \
--header "x-api-key: ${VEXPAY_API_KEY}"curl "${API_URL}/v1/payments/by-ref/order_demo_1042" \
--header "x-api-key: ${VEXPAY_API_KEY}"Reversa un pago C2P
POST /v1/payments/:id/reverse solo es compatible con pagos C2P. Las reglas de la red bancaria y el estado del pago determinan si el reverso puede completarse.
curl --request POST "${API_URL}/v1/payments/PAYMENT_ID/reverse" \
--header "x-api-key: ${VEXPAY_API_KEY}"Estados de pago
| Estado | Significado | Próxima acción |
|---|---|---|
| PENDING | La intención fue creada o la operación espera completarse | Espera la ejecución o concilia por ID de pago. |
| COMPLETED | La red bancaria confirmó el pago | Procesa el pedido cuando se completen tus validaciones comerciales. |
| FAILED | El cobro o la verificación falló | Revisa failureCode y decide si debes solicitar datos corregidos. |
| CANCELED | Intención C2P reemplazada por un intento más nuevo, o expirada a los 15 minutos | No proceses el pedido. Usa cancelReason (superseded | expired). Escucha payment.canceled. |
| REVERSED | Un pago completado fue reversado (reverso C2P, contracargo total de tarjeta o dinero que nunca llegó al banco). Un pago COP reembolsado aparece como refunded. | Actualiza el pedido y conserva las referencias del reverso; reversalType indica cuál. |