Compartir el comprobante de un pago

Cuando un pago queda settled, tu cliente suele pedir una prueba para mandársela a quien recibió el dinero. Con estas tres llamadas la generas desde tu sistema, sin capturas de pantalla.

BASE=https://qa.bolivarconnect.com     # en producción, la URL de producción
KEY=sk_test_...                        # en producción, tu sk_live_
PAGO=89920401-26da-4f69-b57d-bc20e0366ce2

Qué lleva y qué no

Lleva	No lleva
«Enviado por» con el nombre de tu empresa	Montos en USD o USDT
Monto en Bs	Tasa ni comisión
Beneficiario enmascarado: «Ana P.», `V-*****123`, últimos 4 de la cuenta o el teléfono	La red de pago ni su referencia
Banco por su nombre y la referencia bancaria (`bank_reference`)	Tu `Idempotency-Key`
Fecha y hora de Venezuela con su desfase (`-04:00`)	Datos de tu cuenta
Estado, concepto (tu `reference`) y número de comprobante (el id del pago)

Pide el comprobante (JSON o imagen)

Con payments:read:

curl "$BASE/v1/payments/$PAGO/receipt" -H "x-api-key: $KEY"
curl "$BASE/v1/payments/$PAGO/receipt?format=png&lang=en" -H "x-api-key: $KEY" -o comprobante.png

format=png da una imagen de 1080×1350 lista para WhatsApp. lang (es por defecto, o en) cambia las etiquetas.

{
  "receipt_number": "89920401-26da-4f69-b57d-bc20e0366ce2",
  "status": "settled",
  "sender_name": "Tu empresa",
  "amount": "50000.00",
  "asset": "BS",
  "method": "pago_movil",
  "beneficiary": { "name": "Ana P.", "national_id": "V-*****123", "account": null, "phone": "****4567" },
  "bank": { "code": "0102", "name": "Banco de Venezuela" },
  "bank_reference": "012345678901",
  "concept": "INV-2026-0042",
  "settled_at": "2026-08-31T19:06:44.120Z",
  "settled_at_local": "2026-08-31T15:06:44-04:00",
  "time_zone": "America/Caracas",
  "lang": "es",
  "verify": "Verifica este comprobante en bolivarconnect.com"
}

O crea un enlace para compartir

Con payments:write (la misma que usas para dispersar):

curl -X POST "$BASE/v1/payments/$PAGO/receipt-links" -H "x-api-key: $KEY" \
  -H 'content-type: application/json' -d '{"expires_in_days":7}'

{ "id": "0b6a9f8e-3f2c-4c7a-9a43-1d2e5f6a7b8c",
  "url": "https://qa.bolivarconnect.com/receipt#3f9c…9d8e",
  "expires_at": "2026-09-07T19:06:44.120Z" }

La url se muestra solo en esta respuesta: guárdala o mándala ya. Quien la abre ve el comprobante sin cuenta ni contraseña.

Revócalo si hace falta
Sección titulada «Revócalo si hace falta»
Ventana de terminal
```
curl -X DELETE "$BASE/v1/payments/$PAGO/receipt-links/0b6a9f8e-3f2c-4c7a-9a43-1d2e5f6a7b8c" -H "x-api-key: $KEY"
```
Responde 204 y el enlace deja de abrir en el momento.

Cómo se protege el enlace

El código va después del #. El navegador no lo envía a ningún servidor, así que no queda en registros de acceso, proxies ni en la cabecera Referer. Nosotros solo guardamos su huella (SHA-256).
Vence a los 7 días por defecto; puedes pedir de 1 a 30 (expires_in_days fuera de ese rango da 400).
Hasta 20 enlaces vivos por pago (409 receipt_link_limit_reached).
Deja de abrir si se revoca o si tu cuenta se suspende. Vencido, revocado o inventado, la respuesta es la misma: 404 receipt_not_found.
La página no se indexa en buscadores ni se guarda en caché.

Errores

Código	Cuándo
`404 payment_not_found`	El pago no existe o no es de tu cuenta
`409 receipt_not_available`	El pago no llegó a `settled` (o, para crear un enlace, no está `settled` ahora)
`409 receipt_link_limit_reached`	El pago ya tiene 20 enlaces vivos: revoca alguno
`404 receipt_not_found`	Al revocar: el enlace no existe o es de otro pago
`400 validation_failed`	`format`, `lang` o `expires_in_days` fuera de lo permitido

Desde el panel de tu empresa también puedes descargar la imagen, imprimirla o crear el enlace en el detalle de cada orden.