Anular payment

POST /v3/payment/{uuid}/refund

Ambiente	URL base API	Portal de comercio
Sandbox	https://api.virtualpos-sandbox.com	comercios.virtualpos-sandbox.com
Producción	https://api.virtualpos.cl	comercios.virtualpos.cl

Headers

Nombre	Tipo	Requerido	Descripción
Content-Type	string	No	Por defecto: application/json.
Authorization	string	Sí	API KEY del comercio
Signature	string	Sí	Firma del mensaje

Body

Campo	Tipo	Requerido	Descripción
amount	integer (int32)	Sí	Monto de la transacción a anular total o parcial.

Ejemplo de request

curl -X POST 'https://api.virtualpos-sandbox.com/v3/payment/{uuid}/refund' \
  -H 'Content-Type: application/json' \
  -H "Authorization: $API_KEY" \
  -H "Signature: $SIGNATURE" \
  -d '{
  "amount": 0
}'

Respuestas

200 OK

{
    "payment_uuid": "31477136a5665c26",
    "amount": 15000,
    "status": "approved",
    "auth_code": "418414",
    "authorized_at": "2026-07-14 12:38:56",
    "retention_date": "2026-07-17"
}

400 Bad Request

{
  "status": "NOK",
  "code": 400,
  "error": {
    "error_code": "E-###",
    "message": "detalle del error",
    "doc_url": "https://virtualpos.readme.io/reference/objeto-error"
  }
}