Sign up a new user

post
Sign-up
https://api.vndc.io/merchant/register_account
A merchant can create a new account for a new user that they referred.
Request
Response
Request
Headers
Accept
required
string
application/json
Access-Client-Token
required
string
The token that provided of merchants.
Content-Type
required
string
application/json
Body Parameters
name
required
string
Full name
account
required
string
Email / Phone
password
required
string
Password
Response
200: OK
Successfully
{
    "code": "success",
    "message": "Đăng ký thành công. Vui lòng kiểm tra email để kích hoạt.",
    "data": {
        "user": {
            "id": "6277729709289981854",
            "display": "Test User 2",
            "shortDisplay": "4936354455"
        },
        "generatedPasswords": [],
        "rootUrl": "https://wallet.vndc.io/email",
        "principals": [
            {
                "value": "4936354455",
                "type": {
                    "id": "6277729709576826782",
                    "name": "Login name",
                    "internalName": "username",
                    "kind": "username"
                }
            },
            {
                "value": "[email protected]",
                "type": {
                    "id": "6277729709576828830",
                    "name": "E-mail",
                    "internalName": "email",
                    "kind": "email"
                }
            }
        ],
        "status": "emailValidation"
    }
}
401: Unauthorized
{
    "code": "missingAuthorization",
    "message": "Unauthorized access. Missing or invalid access client token"
}
​
Possible values are:
. unauthorized_access: Unauthorized access. Missing or invalid crendentials supplied for such operation
. invalidAccount: Thông tin tài khoản không hợp lệ
. missingAuthorization: Unauthorized access. Missing or invalid access client token
403: Forbidden
{
    "code": "permission_denied",
    "message": "Permission denied for such operation"
}
​
Possible values are:
. permission_denied: Permission denied for such operation		
. sendVerificationCodeFailure: Gửi mã xác thực thất bại
404: Not Found
{
    "code": "emptyInputValue",
    "message": "Thông tin đăng ký không đầy đủ"
}
​
Possible values are:
. emptyInputValue: Thông tin đăng ký không đầy đủ
. not_found_data: An expected data was not found
422: Unprocessable Entity
{
    "code": "validationInput",
    "message": "Input error. Either a validation error or the maximum allowed items was exceeded"
}
​
Possible message values are:
. Input error. Either a validation error or the maximum allowed items was exceeded
. Địa chỉ Email đăng ký đã tồn tại trong hệ thống
. Địa chỉ Email đăng ký không hợp lệ
. Số điện thoại đăng ký đã tồn tại trong hệ thống
. Số điện thoại đăng ký không hợp lệ
. Mật khẩu tối thiểu 6 ký tự
. Mật khẩu xác nhận không hợp lệ
500: Internal Server Error
{
    "code": "unexpected_error",
    "message": "Unexpected error"
post
Resend phone verification code
https://api.vndc.io/merchant/resend_verification_code
Send OTP to verify the user again.
Request
Response
Request
Body Parameters
password
required
string
The password of user
account
required
string
User ID, email or password
Response
200: OK
{
    "code": "success",
    "message": "Gửi mã xác thực thành công"
}
401: Unauthorized
{
    "code": "invalidAccount",
    "message": "Thông tin tài khoản không hợp lệ"
}
​
Possible values are:
. invalidAccount: Thông tin tài khoản không hợp lệ
. missingAuthorization: Unauthorized access. Missing or invalid access client token
403: Forbidden
{
    "code": "sendVerificationCodeFailure",
    "message": "Gửi mã xác thực thất bại"
}
404: Not Found
{
    "code": "emptyAccount",
    "message": "Tài khoản được yêu cầu"
}
​
Possible values are:
. emptyAccount: Tài khoản được yêu cầu
. emptyPassword: Mật khẩu được yêu cầu
post
Verify the phone
https://api.vndc.io/merchant/verify_phone
Request
Response
Request
Body Parameters
authen_code
required
string
The OTP code that sent to user via phone number or email.
password
required
string
Password
account
required
string
Email / Username
Response
200: OK
{
    "code": "success",
    "message": "Kích hoạt SMS thành công"
}
401: Unauthorized
{
    "code": "unauthorized_access",
    "message": "Unauthorized access. Missing or invalid crendentials supplied for such operation"
}
​
Possible values are:
. unauthorized_access: Unauthorized access. Missing or invalid crendentials supplied for such operation
. invalidAccount: Thông tin tài khoản không hợp lệ
. missingAuthorization: Unauthorized access. Missing or invalid access client token
403: Forbidden
{
    "code": "unauthorized_access",
    "message": "Permission denied for such operation"
}
​
Possible values are:
. permission_denied: Permission denied for such operation		
. codeNotSent: Mã xác thực chưa được gửi. Vui lòng gửi lại mã xác thực
. expired: Mã xác thực hết hạn
. failed: Mã xác thực không hợp lệ
. maxAttemptsReached: Bạn nhập sai mã xác thực quá nhiều lần. Vui lòng gửi lại mã xác thực.
404: Not Found
{
    "code": "unauthorized_access",
    "message": "Unauthorized access. Missing or invalid crendentials supplied for such operation"
}
​
Possible values are:
. unauthorized_access: Unauthorized access. Missing or invalid crendentials supplied for such operation
. invalidAccount: Thông tin tài khoản không hợp lệ
. missingAuthorization: Unauthorized access. Missing or invalid access client token
500: Internal Server Error
{
    "code": "unexpected_error",
    "message": "Unexpected error"
}
​
3-Party Integration - Previous
Redeem by VNDC
Send off-chain
Last updated 5 months ago
Sign up a new user

postSign-up

postResend phone verification code

postVerify the phone

post
Sign-up

post
Resend phone verification code

post
Verify the phone
