VE BankingGuía para desarrolladores
Referencia de API
Explorar documentación

Consulta y reversa pagos

Concilia por el ID del gateway o la referencia de correlación, y reversa pagos C2P elegibles.

Consulta de pagos

Por ID de pagobash
curl "${API_URL}/v1/payments/PAYMENT_ID" \
  --header "x-api-key: ${VE_BANKING_API_KEY}"
Por referencia externabash
curl "${API_URL}/v1/payments/by-ref/order_demo_1042" \
  --header "x-api-key: ${VE_BANKING_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.

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

Estados de pago

EstadoSignificadoPróxima acción
PENDINGLa intención fue creada o la operación espera completarseEspera la ejecución o concilia por ID de pago.
COMPLETEDLa red bancaria confirmó el pagoProcesa el pedido cuando se completen tus validaciones comerciales.
FAILEDEl cobro o la verificación fallóRevisa failureCode y decide si debes solicitar datos corregidos.
REVERSEDUn pago C2P completado fue reversadoActualiza el pedido y conserva las referencias del reverso.