Pay
SolucionesDemo

Developers/Guías

Promociones QR (cashback)

Reintegro al CVU del comprador después de un pago QR billetera finalizado. El importe del QR ante Coelsa no cambia.

Cuentas y CVUTransferenciasPago QRDEBINWebhooksPromociones QRComprobantesReferencia API

Flujo

  1. Creás la campaña (POST /v1/promos) con CVU de fondeo.
  2. El PSP inicia el pago con POST /v1/qr/pay y opcional promoCode.
  3. Tras QROperacionFinalizada, Gallo acredita el cashback con comprobante PROMO_REINTEGRO.
  4. Recibís webhook promo.applied o promo.skipped.

QR pay con cupón

POST /v1/qr/pay
{
  "compradorCuit": "20123456789",
  "compradorCbu": "0000003100010000000001",
  "vendedorCuit": "30987654321",
  "vendedorCbu": "0000003100010000000099",
  "vendedorBanco": "431",
  "importe": 1500,
  "moneda": "032",
  "promoCode": "VERANO10"
}

Si el código no matchea ninguna campaña activa, el pago QR sigue OK; recibirás promo.skipped con reason: invalid_code.

Preview (best-effort)

GET /v1/promos/preview?cvu=0000003100010000000001&amount=1500&promoCode=VERANO10

Estimación antes del pago. El presupuesto y topes pueden cambiar entre preview y settlement.

Webhooks

  • promo.applied — cashback acreditado
  • promo.skipped — sin match, presupuesto agotado, fondeo insuficiente, cupón inválido
  • promo.reversed — clawback por chargeback / reverso

Mismo HMAC que el resto de eventos — ver guía de webhooks.

API de campañas

Permisos: promos.read, promos.manage. Segmentación por tags: POST /v1/accounts/:cvu/tags.

Referencia OpenAPI: /developers/referencia (tag promotions).