Comprobantes y ledger

Modelo

Los saldos viven en ledger_accounts + ledger_movements. La capa de comprobantes solo proyecta; no reescribe el pipeline de transferencias.

Tipos de sistema: holds/confirmaciones de transfer, créditos inbound y reversas. También tipos custom del tenant.

Endpoints nativos

• GET /v1/voucher-types
• GET /v1/accounts/:cvu/comprobantes
• POST /v1/accounts/:cvu/comprobantes — ajuste idempotente (idExterno)
• GET /v1/comprobantes/:id
• GET /v1/comprobantes/by-external/:idExterno

Ejemplos curl

Listar

curl "https://api.dev.gallo-pay.com/v1/accounts/0000003100000000000147/comprobantes?limit=50" \
  -H "x-api-key: gpk_test_…"

Ajuste custom (idempotente)

# requiere un voucher type custom previo (POST /v1/voucher-types)
curl -X POST https://api.dev.gallo-pay.com/v1/accounts/0000003100000000000147/comprobantes \
  -H "x-api-key: gpk_test_…" \
  -H "Content-Type: application/json" \
  -d '{
    "voucherTypeCode": "PROMO_REINTEGRO",
    "amount": 150.5,
    "idExterno": "promo-2026-08-0042",
    "description": "Promo verano CVU"
  }'

Fachada /wallet/v1

curl "https://api.dev.gallo-pay.com/wallet/v1/ComprobantesByFilters?page=1&pageSize=50" \
  -H "x-api-key: gpk_test_…"

curl -X POST https://api.dev.gallo-pay.com/wallet/v1/Comprobante \
  -H "x-api-key: gpk_test_…" \
  -H "Content-Type: application/json" \
  -d '{
    "idCuenta": 123,
    "codigo": "PROMO_REINTEGRO",
    "importe": 150.5,
    "idExterno": "promo-2026-08-0042",
    "signo": 1
  }'

Signo Bind: 1 crédito, -1 débito. Extensión: sentido = hold | release | confirm_hold.

Mapping movement → comprobante

Referencia API · Cuentas y CVU.