Block Driver Wallet Path Parameters UUID of the driver whose wallet should be blocked
Body Parameters Reason for blocking the wallet (max 250 characters). Used for audit and traceability.
Additional comment or context (max 500 characters)
Response Indicates if the operation was successful
Response message indicating whether the wallet was blocked or was already blocked
Wallet status change details Previous wallet status (active or blocked)
Current wallet status (blocked)
Whether the status actually changed. False if wallet was already blocked.
ISO 8601 timestamp of when the change occurred
Example Request curl -X POST https://api.rodando.com/wallets-status/3a0c239d-7a63-43b2-a9b3-25b0f3a7a2cd/block \ -H "Content-Type: application/json" \ -d '{ "reason": "Sospecha de fraude en transacción", "comment": "Bloqueo preventivo hasta resolver disputa #D-1234" }'
Example Response { "success" : true , "message" : "Wallet bloqueado." , "data" : { "driverId" : "3a0c239d-7a63-43b2-a9b3-25b0f3a7a2cd" , "previousStatus" : "active" , "status" : "blocked" , "changed" : true , "changedAt" : "2025-09-14T10:00:00.000Z" } }
Wallet Blocked Behavior When a wallet is in blocked status:
Prevented Operations:
Payouts to the driver
Withdrawals and other egress transactions
Allowed Operations:
Top-ups (deposits)
Regularization adjustments by admin
Error Responses
404 Not Found : Driver wallet does not exist400 Bad Request : Invalid request parameters
This is a critical financial control operation. Ensure proper authorization checks are in place before allowing wallet blocking. Consider implementing admin-only access control for production use.
Unblock Driver Wallet Path Parameters UUID of the driver whose wallet should be unblocked
Body Parameters Reason for unblocking the wallet (max 250 characters)
Additional comment or context (max 500 characters)
Response Indicates if the operation was successful
Response message indicating whether the wallet was unblocked or was already active
Wallet status change details Previous wallet status (active or blocked)
Current wallet status (active)
Whether the status actually changed. False if wallet was already active.
ISO 8601 timestamp of when the change occurred
Example Request curl -X POST https://api.rodando.com/wallets-status/3a0c239d-7a63-43b2-a9b3-25b0f3a7a2cd/unblock \ -H "Content-Type: application/json" \ -d '{ "reason": "Disputa resuelta", "comment": "Se validó identidad del conductor y se cerró el ticket" }'
Example Response { "success" : true , "message" : "Wallet desbloqueado." , "data" : { "driverId" : "3a0c239d-7a63-43b2-a9b3-25b0f3a7a2cd" , "previousStatus" : "blocked" , "status" : "active" , "changed" : true , "changedAt" : "2025-09-14T11:30:00.000Z" } }
Error Responses
404 Not Found : Driver wallet does not exist400 Bad Request : Invalid request parameters
Both block and unblock operations are idempotent. The changed field in the response indicates whether the operation actually changed the wallet status or if it was already in the target state.
Use Cases Fraud Prevention When suspicious activity is detected, block the wallet immediately to prevent unauthorized withdrawals:
curl -X POST https://api.rodando.com/wallets-status/{driverId}/block \ -H "Content-Type: application/json" \ -d '{ "reason": "Patrón de actividad sospechosa detectado", "comment": "Multiple payouts requested in short timeframe. Investigation ticket #SEC-5678" }'
Dispute Resolution After resolving a dispute and verifying the driver’s identity, unblock the wallet:
curl -X POST https://api.rodando.com/wallets-status/{driverId}/unblock \ -H "Content-Type: application/json" \ -d '{ "reason": "Disputa cerrada - identidad verificada", "comment": "Ticket #SUP-1234 resolved. Driver provided valid documentation." }'
Regulatory Compliance Block wallets for drivers who haven’t completed required compliance checks:
curl -X POST https://api.rodando.com/wallets-status/{driverId}/block \ -H "Content-Type: application/json" \ -d '{ "reason": "Documentación vencida", "comment": "Licencia de conducir expirada. Requiere actualización antes de desbloqueo." }'
See Also 