Submit Invitation

POST

/api/v1/vendor/invitation/submit

Generates the token and URL for Vendor to send to the borrower.

Request

Header Params

Body Params application/json

Example

[
    {
        "reference_id": "{{VENDOR_ID}}-{{$timestamp}}",
        "borrower": {
            "full_name": "Ali Bin Abu",
            "phone_code": "60",
            "phone_number": "123456789",
            "identity_no": "901010105555",
            "email": "ali@example.com",
            "nationality_code": "MY"
        }
    },
    {
        "reference_id": "{{VENDOR_ID}}-{{$timestamp}}",
        "borrower": {
            "full_name": "Tang Jian Yang",
            "phone_code": "60",
            "phone_number": "123456788",
            "identity_no": "001031085555",
            "email": "jy@example.com",
            "nationality_code": "MY"
        }
    }
]

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://portal-staging-api.vestiuum.com.my//api/v1/vendor/invitation/submit' \
--header 'Authorization: Bearer {{api_key}}' \
--header 'Content-Type: application/json' \
--data-raw '[
    {
        "reference_id": "{{VENDOR_ID}}-{{$timestamp}}",
        "borrower": {
            "full_name": "Ali Bin Abu",
            "phone_code": "60",
            "phone_number": "123456789",
            "identity_no": "901010105555",
            "email": "ali@example.com",
            "nationality_code": "MY"
        }
    },
    {
        "reference_id": "{{VENDOR_ID}}-{{$timestamp}}",
        "borrower": {
            "full_name": "Tang Jian Yang",
            "phone_code": "60",
            "phone_number": "123456788",
            "identity_no": "001031085555",
            "email": "jy@example.com",
            "nationality_code": "MY"
        }
    }
]'

Responses

🟢200Success Request

application/json

Body

Example

[
  {
    "status": true,
    "reference_id": "TEST-TRX-8888",
    "token": "vt_7a8b9c0d1e2f3g4h",
    "expire_datetime": "2026-01-19 10:30:00",
    "register_url": "https://portal.vestiuum.com.my/onboard?token=vt_7a8b9c0d1e2f3g4h",
    "error_message": ""
  }
]

🟠400Bad Request

🟠403Forbidden

Modified at 2026-02-25 03:23:02

Check Invitation Status