Skip to main content

Change Transaction PIN Flow

📋 Overview​

Complete workflow for changing a user's existing transaction PIN. The user must first verify their current transaction PIN, then enter and confirm a new transaction PIN.

🔄 Workflow Steps​

Step 1: Current Transaction PIN Verification​

  • User enters their existing transaction PIN
  • System calls the Verify Transaction PIN API to validate the current transaction PIN
  • If verification is successful and returns a success message, transaction PIN verification is complete
  • If verification fails, show error message and ask user to retry

Step 2: New Transaction PIN Input​

  • After successful current transaction PIN verification, user enters new transaction PIN
  • User confirms the new transaction PIN by entering it again
  • Frontend validates that both PINs match

Step 3: Change Transaction PIN API Call​

  • Once new transaction PIN is confirmed, system calls the Update Transaction PIN API
  • Include the new transaction PIN and user_id in the request body

📡 API References​

Step 1: Verify Current Transaction PIN​

  • API: Verify Transaction PIN API
  • Purpose: Validate the user's current transaction PIN before allowing changes
  • Returns: Success message on successful verification

Step 2: Change Transaction PIN​

Note: For complete API details, request/response formats, and error codes, please refer to the individual API documentation pages linked above.

🔄 Flow Logic​

  1. User enters current transaction PIN → Call Verify Transaction PIN API
  2. If verification succeeds → Proceed to new transaction PIN input
  3. If verification fails → Show error, return to current transaction PIN input
  4. User enters new transaction PIN → Validate format and confirmation
  5. Call Update Transaction PIN API → Use user_id and new PIN
  6. If change succeeds → Show success message
  7. If change fails → Show error message

This workflow ensures secure transaction PIN changes by requiring current transaction PIN verification before allowing any modifications.