Payments API

API publica para consultar pagos y crear reembolsos.

Autenticacion

Todos los endpoints de esta seccion requieren:

Header	Valor	Descripcion
Authorization	Bearer {API_KEY}	API Key privada
x-client-id	{CLIENT_ID}	Identificador de cliente
Content-Type	application/json	Tipo de contenido

---

1) Obtener Payment

Endpoint

GET /api/payments/{id}

URL Parameters

Parametro	Tipo	Requerido	Descripcion
id	String	Si	ID del pago o transferencia

Respuesta exitosa (200)

{
  "id": "67a8f1b2c3d4e5f6a7b8c9d0",
  "amount": 15000,
  "currency": "ARS",
  "status": "approved",
  "date": "2026-02-10T14:21:00.000Z",
  "referenceId": "orden-456",
  "type": "card",
  "moneyReleaseDate": "2026-02-12T00:00:00.000Z",
  "netAmount": 14650
}

Errores frecuentes

{
  "error": "Payment not found"
}

{
  "error": "Payment link not found"
}

{
  "error": "Unauthorized"
}

cURL

curl -X GET "https://pay.galio.app/api/payments/67a8f1b2c3d4e5f6a7b8c9d0" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer TU_API_KEY" \
  -H "x-client-id: TU_CLIENT_ID"

---

2) Reembolsar Payment

Endpoint

POST /api/payments/{id}/refund

Nota: si el pago pertenece a un payment link sandbox, el reembolso se simula y no ejecuta una transferencia bancaria real.

URL Parameters

Parametro	Tipo	Requerido	Descripcion
id	String	Si	ID del pago/transferencia a reembolsar

Body Parameters

Parametro	Tipo	Requerido	Descripcion
reason	String	No	Motivo del reembolso
refundType	String	No	total o partial
refundAmount	Number	No	Monto para reembolso parcial

Respuesta exitosa (200)

{
  "success": true,
  "message": "Payment refunded successfully",
  "payment": {
    "id": "67a8f1b2c3d4e5f6a7b8c9d0",
    "status": "refunded"
  }
}

Errores frecuentes

{
  "error": "Payment not found"
}

{
  "error": "Payment is already refunded"
}

{
  "error": "Invalid refundType. Use 'total' or 'partial'."
}

cURL

curl -X POST "https://pay.galio.app/api/payments/67a8f1b2c3d4e5f6a7b8c9d0/refund" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer TU_API_KEY" \
  -H "x-client-id: TU_CLIENT_ID" \
  -d '{
    "reason": "Cliente solicito devolucion",
    "refundType": "total"
  }'