Reset Password

Overview

Many clients choose to offer the guest a way to reset their password without calling or emailing the corporate office. We offer several different options for resetting a guest’s password via REST, though all result in a password reset email being sent from the Paytronix system to the email address on the guest’s account. In order to perform the necessary call you must have the guest’s printed card number, username, or email address.

Authentication

This particular flow only supports an authentication type of anonymous.

Flow

../_images/reset_password.png
  1. Guest supplies printed card number, username, or email address

  2. Integration sends resetPassword call using one of the above pieces of information in step 1

  3. The Paytronix system will return a result of success, failure, or more_info

    1. If the result is success then the integration should inform the guest that they will receive a password reset email shortly

    2. If the result is failure then the integration should inform the guest that they will not receive a password reset email. It is suggested that the integration uses the error code and error message returned by the system to inform the guest of the problem, though the merchant should decide on the exact message

    3. If the result is more_info then the guest will need to provide additional information. The steps will be:

      i. Integration sends enrollmentConfig call to obtain password hint questions

      ii. Integration prompts the guest to answer one of the password hint questions and again provide card number, username, or email address

      iii. Back to step 2

Example

Request Body

{
        "authentication": "anonymous",
        "client_id": "3FTmkQuXBthisisnotarealclientidO9PREEnj_WHaK",
        "client_secret": "test123",
        "merchantId": 777777,
        "username": "johndoe"
}

Response

{
        "result":"success",
        "email":"johndoe@paytronix.com"
}

API Reference

Please see the following API reference page for more technical details: Guest Service