Account Transfer

Transfer Process Flow

Step 1: Reseller Initiates Transfer

POST /1/transfer/request
{
    "email": "[email protected]"
}

Step 2: User Receives Email

User gets email with:

• 6-digit verification code (e.g., 123456)
• Link to transfer confirmation page
• Details about what will be transferred

Step 3: User Reviews Transfer

1. User clicks link in email
2. Enters 6-digit verification code
3. Reviews organizations to be transferred
4. Removes any co-administrators (required)
5. Clicks "Confirm Transfer"

Step 4: User Gets Confirmation Code

After confirming, user sees:

Your confirmation code is: K3N2P-8FG4M
Please provide this code to your reseller.

Step 5: Reseller Completes Transfer

POST /1/transfer/confirm
{
    "email": "[email protected]",
    "confirmationCode": "K3N2P-8FG4M"
}

Step 6: Transfer Complete

• User is now under reseller's management
• User's organizations and learners are accessible to reseller
• Other users lose access to transferred organizations

Important Notes

Security Features

• Two-factor verification: Email verification code + confirmation code
• Rate limiting: Maximum 3 requests per email per day
• Time limits: Requests expire after 1 hour
• Sole administrator requirement: User must be only admin of their organizations

What Transfers

• ✅ User account association with reseller
• ✅ Access to user's organizations
• ✅ Access to all learners in those organizations
• ✅ Purchase history and assessments

Error Handling

• Always check the success field in responses
• Handle rate limiting with exponential backoff
• Expired requests require starting over with new transfer request
• Email send failures should be reported to support

Testing in Sandbox

Use the sandbox environment for testing:

https://api-sandbox.vbmappapp.com/1/transfer/request
https://api-sandbox.vbmappapp.com/1/transfer/confirm

Support

For issues with transfers, contact DataMTD support:

• Visit: https://datamtd.com/contact
• Include transfer request details and error messages