Skip to main content
The new password will be set, and the wallet will be active and ready for use.

​
Prerequisites

  • Valid recovery code obtained from the wallet recovery endpoint
  • Wallet username in the format <walletUsername>@<appId>
  • New password meeting security requirements

​
Request

curl -X POST "https://api.g2cplatform.com/v2/auth/wallet/reset" \
  -H "Content-Type: application/json" \
  -d '{
    "username": "john@myapp123",
    "recoveryCode": "RECOVER123ABC",
    "newPassword": "NewSecurePassword123!"
  }'

​
Request Body

FieldTypeRequiredDescription
usernamestringYesUsername in format <walletUsername>@<appId>
recoveryCodestringYesRecovery code received via email
newPasswordstringYesNew password (minimum 8 characters)

​
Response

{
  "message": "Password reset successful",
  "timestamp": "2024-03-15T10:30:00Z"
}

​
Response Fields

FieldTypeDescription
messagestringConfirmation message about the password reset
timestampstringISO 8601 timestamp of the response

​
Error Responses

Status CodeDescription
400Invalid request format, expired recovery code, or weak password
404Wallet not found with the provided username
500Internal server error

​
Password Requirements

  • Minimum 8 characters
  • At least one uppercase letter
  • At least one lowercase letter
  • At least one number
  • At least one special character

​
Usage Notes

  • Recovery codes are single-use and expire after successful password reset
  • The wallet becomes immediately active after successful password reset
  • You can log in with the new password right after reset
  • Recovery codes typically expire within 24 hours if not used
  • After successful reset, all existing JWT tokens for the wallet are invalidated