Skip to main content
POST
Recargar el saldo de una pulsera

Autorizaciones

Authorization
string
header
requerido

API key del integrador, emitida desde el panel de VENTRY. Formato vk_live_... en producción y vk_test_... en entornos de prueba.

Encabezados

idempotency-key
string
requerido

Parámetros de ruta

code
string
requerido

Cuerpo

application/json
amount
integer
requerido

Importe a añadir, en céntimos. 2500 son 25,00 €.

Rango requerido: 1 <= x <= 100000
bonus_amount
integer

Regalo que se enseñó al cobrar, en céntimos.

Rango requerido: 1 <= x <= 100000
bonus_rule
string

Id de la bonificación que lo da, de GET /topup-bonuses/quote.

Pattern: ^[0-9a-fA-F]{24}$
granted_at
string<date-time>

Cuándo se prometió el regalo (al cobrar). La regla se comprueba en ese momento: una recarga pagada antes del evento puede entregarse cuando la promoción ya terminó. Por defecto, ahora.

Respuesta

Resultado de la recarga.

Resultado de la recarga.

object
enum<string>
Opciones disponibles:
topup_result
id
string
amount
integer
previous_balance
integer
new_balance
integer
bonus_amount
integer

Regalo concedido, en céntimos. 0 si no se pidió o la regla ya no lo permite.

bonus_id
null | string

Id del movimiento del regalo en GET /topups, o null si no hubo.

previous_promo_balance
integer
new_promo_balance
integer

Saldo regalado tras la recarga, ya con el regalo.

replayed
boolean

true si la respuesta se reprodujo de un intento anterior con la misma Idempotency-Key.