Pagos
Consulta el resultado y el estado del dinero.
Los pagos se originan en checkouts y cobros. No existe una operación pública para crear un pago arbitrario desde la API de servidor.
| Método | Ruta | Acción |
|---|---|---|
| GET | /v1/payments | Listar; filtros por cliente y estado |
| GET | /v1/payments/:payment | Consultar |
Comisiones y neto
Un pago exitoso trae settlement: lo que se cobró (amount, en currency, con exchangeRate si hubo conversión), el IVA cobrado en esa moneda (tax), lo que tu negocio paga de comisión (fee) y lo que te queda (net, siempre amount - fee). Tu cliente paga el precio completo: las comisiones salen de tu neto.
Con un precio en dólares o euros pagado en bolívares, Billete convierte cada línea y el descuento a la tasa BCV del pago y calcula el IVA en bolívares sobre esa base: amount es esa base más su IVA, y tax el IVA en bolívares. Por eso amount puede diferir en algún céntimo de convertir el total en dólares. Los pagos convertidos antes de este cálculo no traen tax.
fee suma dos comisiones, que feeDetails separa en unidad menor y en la moneda de settlement:
| Campo | Qué es |
|---|---|
feeDetails.platform | La comisión de Billete, un porcentaje del pago. Se cobra en todo pago. |
feeDetails.method | La del método de pago (Pago Móvil, Débito Inmediato…), solo en los pagos que entran a la cuenta de Billete: un porcentaje con un mínimo, más un monto fijo, en bolívares, según lo que cobra por ese método el proveedor que procesó el pago. 0 en los pagos que entran al banco propio de tu negocio, porque esa te la cobra tu banco, y en los anteriores a esta comisión. |
"settlement": {
"amount": 928000,
"currency": "VES",
"exchangeRate": "800.00000000",
"tax": 128000,
"fee": 13920,
"feeDetails": { "platform": 4640, "method": 9280 },
"net": 914080
}Las comisiones se fijan al liquidarse el pago y no cambian después. Un reembolso no las devuelve. Consulta las de tu negocio en el dashboard, en Configuración › Métodos de pago.
Consulta las acciones de reembolsos y recibos.