Cobrar

POST /v2/charge

Realiza un cobro directo al balance de un usuario que previamente autorizó pagos a tu aplicación. El cobro se procesa inmediatamente.

Autenticación

Credenciales de App (app-id + app-secret en headers).

Request

{
  "amount": 10.00,
  "user_uuid": "uuid-del-usuario",
  "description": "Suscripción mensual",
  "remote_id": "sub-001"
}

Parámetros

Response

{
  "success": true,
  "message": "Se ha aplicado el cargo correctamente",
  "transaction": {
    "uuid": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "amount": 10.00,
    "description": "Suscripción mensual",
    "remote_id": "sub-001",
    "status": "paid",
    "created_at": "2024-06-20T14:30:00.000Z",
    "updated_at": "2024-06-20T14:30:00.000Z"
  }
}

Comisión

Se aplica una comisión del 0.5% sobre el monto cobrado, que se deduce del pagador. Los usuarios con plan GOLD están exentos.

Requisitos

• El usuario debe haber autorizado pagos a tu app previamente (ver Autorizar Pagos)
• Tu app debe tener el permiso allowed_payment_auth habilitado

Rate Limiting

Este endpoint tiene rate limiting de 5 requests cada 20 segundos por app.

Errores