Đăng ký nhận hàng vật chất (bên mua)

curl --request POST \
  --url https://api.fireant.vn/mxv/physical-receive/register \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "area": "<string>",
  "contract": "<string>",
  "quantity": 123,
  "email": "<string>",
  "phone": "<string>",
  "authorization": {
    "fullName": "<string>",
    "dateOfBirth": "<string>",
    "idNumber": "<string>",
    "idIssueDate": "<string>",
    "idIssuePlace": "<string>",
    "address": "<string>",
    "idImageFront": "<string>",
    "idImageBack": "<string>",
    "email": "<string>",
    "phone": "<string>"
  }
}
'

import requests

url = "https://api.fireant.vn/mxv/physical-receive/register"

payload = {
    "area": "<string>",
    "contract": "<string>",
    "quantity": 123,
    "email": "<string>",
    "phone": "<string>",
    "authorization": {
        "fullName": "<string>",
        "dateOfBirth": "<string>",
        "idNumber": "<string>",
        "idIssueDate": "<string>",
        "idIssuePlace": "<string>",
        "address": "<string>",
        "idImageFront": "<string>",
        "idImageBack": "<string>",
        "email": "<string>",
        "phone": "<string>"
    }
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    area: '<string>',
    contract: '<string>',
    quantity: 123,
    email: '<string>',
    phone: '<string>',
    authorization: {
      fullName: '<string>',
      dateOfBirth: '<string>',
      idNumber: '<string>',
      idIssueDate: '<string>',
      idIssuePlace: '<string>',
      address: '<string>',
      idImageFront: '<string>',
      idImageBack: '<string>',
      email: '<string>',
      phone: '<string>'
    }
  })
};

fetch('https://api.fireant.vn/mxv/physical-receive/register', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.fireant.vn/mxv/physical-receive/register",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'area' => '<string>',
    'contract' => '<string>',
    'quantity' => 123,
    'email' => '<string>',
    'phone' => '<string>',
    'authorization' => [
        'fullName' => '<string>',
        'dateOfBirth' => '<string>',
        'idNumber' => '<string>',
        'idIssueDate' => '<string>',
        'idIssuePlace' => '<string>',
        'address' => '<string>',
        'idImageFront' => '<string>',
        'idImageBack' => '<string>',
        'email' => '<string>',
        'phone' => '<string>'
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.fireant.vn/mxv/physical-receive/register"

	payload := strings.NewReader("{\n  \"area\": \"<string>\",\n  \"contract\": \"<string>\",\n  \"quantity\": 123,\n  \"email\": \"<string>\",\n  \"phone\": \"<string>\",\n  \"authorization\": {\n    \"fullName\": \"<string>\",\n    \"dateOfBirth\": \"<string>\",\n    \"idNumber\": \"<string>\",\n    \"idIssueDate\": \"<string>\",\n    \"idIssuePlace\": \"<string>\",\n    \"address\": \"<string>\",\n    \"idImageFront\": \"<string>\",\n    \"idImageBack\": \"<string>\",\n    \"email\": \"<string>\",\n    \"phone\": \"<string>\"\n  }\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.fireant.vn/mxv/physical-receive/register")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"area\": \"<string>\",\n  \"contract\": \"<string>\",\n  \"quantity\": 123,\n  \"email\": \"<string>\",\n  \"phone\": \"<string>\",\n  \"authorization\": {\n    \"fullName\": \"<string>\",\n    \"dateOfBirth\": \"<string>\",\n    \"idNumber\": \"<string>\",\n    \"idIssueDate\": \"<string>\",\n    \"idIssuePlace\": \"<string>\",\n    \"address\": \"<string>\",\n    \"idImageFront\": \"<string>\",\n    \"idImageBack\": \"<string>\",\n    \"email\": \"<string>\",\n    \"phone\": \"<string>\"\n  }\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.fireant.vn/mxv/physical-receive/register")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"area\": \"<string>\",\n  \"contract\": \"<string>\",\n  \"quantity\": 123,\n  \"email\": \"<string>\",\n  \"phone\": \"<string>\",\n  \"authorization\": {\n    \"fullName\": \"<string>\",\n    \"dateOfBirth\": \"<string>\",\n    \"idNumber\": \"<string>\",\n    \"idIssueDate\": \"<string>\",\n    \"idIssuePlace\": \"<string>\",\n    \"address\": \"<string>\",\n    \"idImageFront\": \"<string>\",\n    \"idImageBack\": \"<string>\",\n    \"email\": \"<string>\",\n    \"phone\": \"<string>\"\n  }\n}"

response = http.request(request)
puts response.read_body

{
  "time": "<string>",
  "success": true,
  "code": "<string>",
  "msg": "<string>",
  "confirmationCode": "<string>",
  "payload": [
    {
      "confirmationcode": "<string>"
    }
  ]
}

POST

mxv

physical-receive

Đăng ký nhận hàng vật chất (bên mua)

curl --request POST \
  --url https://api.fireant.vn/mxv/physical-receive/register \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "area": "<string>",
  "contract": "<string>",
  "quantity": 123,
  "email": "<string>",
  "phone": "<string>",
  "authorization": {
    "fullName": "<string>",
    "dateOfBirth": "<string>",
    "idNumber": "<string>",
    "idIssueDate": "<string>",
    "idIssuePlace": "<string>",
    "address": "<string>",
    "idImageFront": "<string>",
    "idImageBack": "<string>",
    "email": "<string>",
    "phone": "<string>"
  }
}
'

import requests

url = "https://api.fireant.vn/mxv/physical-receive/register"

payload = {
    "area": "<string>",
    "contract": "<string>",
    "quantity": 123,
    "email": "<string>",
    "phone": "<string>",
    "authorization": {
        "fullName": "<string>",
        "dateOfBirth": "<string>",
        "idNumber": "<string>",
        "idIssueDate": "<string>",
        "idIssuePlace": "<string>",
        "address": "<string>",
        "idImageFront": "<string>",
        "idImageBack": "<string>",
        "email": "<string>",
        "phone": "<string>"
    }
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    area: '<string>',
    contract: '<string>',
    quantity: 123,
    email: '<string>',
    phone: '<string>',
    authorization: {
      fullName: '<string>',
      dateOfBirth: '<string>',
      idNumber: '<string>',
      idIssueDate: '<string>',
      idIssuePlace: '<string>',
      address: '<string>',
      idImageFront: '<string>',
      idImageBack: '<string>',
      email: '<string>',
      phone: '<string>'
    }
  })
};

fetch('https://api.fireant.vn/mxv/physical-receive/register', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.fireant.vn/mxv/physical-receive/register",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'area' => '<string>',
    'contract' => '<string>',
    'quantity' => 123,
    'email' => '<string>',
    'phone' => '<string>',
    'authorization' => [
        'fullName' => '<string>',
        'dateOfBirth' => '<string>',
        'idNumber' => '<string>',
        'idIssueDate' => '<string>',
        'idIssuePlace' => '<string>',
        'address' => '<string>',
        'idImageFront' => '<string>',
        'idImageBack' => '<string>',
        'email' => '<string>',
        'phone' => '<string>'
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.fireant.vn/mxv/physical-receive/register"

	payload := strings.NewReader("{\n  \"area\": \"<string>\",\n  \"contract\": \"<string>\",\n  \"quantity\": 123,\n  \"email\": \"<string>\",\n  \"phone\": \"<string>\",\n  \"authorization\": {\n    \"fullName\": \"<string>\",\n    \"dateOfBirth\": \"<string>\",\n    \"idNumber\": \"<string>\",\n    \"idIssueDate\": \"<string>\",\n    \"idIssuePlace\": \"<string>\",\n    \"address\": \"<string>\",\n    \"idImageFront\": \"<string>\",\n    \"idImageBack\": \"<string>\",\n    \"email\": \"<string>\",\n    \"phone\": \"<string>\"\n  }\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.fireant.vn/mxv/physical-receive/register")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"area\": \"<string>\",\n  \"contract\": \"<string>\",\n  \"quantity\": 123,\n  \"email\": \"<string>\",\n  \"phone\": \"<string>\",\n  \"authorization\": {\n    \"fullName\": \"<string>\",\n    \"dateOfBirth\": \"<string>\",\n    \"idNumber\": \"<string>\",\n    \"idIssueDate\": \"<string>\",\n    \"idIssuePlace\": \"<string>\",\n    \"address\": \"<string>\",\n    \"idImageFront\": \"<string>\",\n    \"idImageBack\": \"<string>\",\n    \"email\": \"<string>\",\n    \"phone\": \"<string>\"\n  }\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.fireant.vn/mxv/physical-receive/register")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"area\": \"<string>\",\n  \"contract\": \"<string>\",\n  \"quantity\": 123,\n  \"email\": \"<string>\",\n  \"phone\": \"<string>\",\n  \"authorization\": {\n    \"fullName\": \"<string>\",\n    \"dateOfBirth\": \"<string>\",\n    \"idNumber\": \"<string>\",\n    \"idIssueDate\": \"<string>\",\n    \"idIssuePlace\": \"<string>\",\n    \"address\": \"<string>\",\n    \"idImageFront\": \"<string>\",\n    \"idImageBack\": \"<string>\",\n    \"email\": \"<string>\",\n    \"phone\": \"<string>\"\n  }\n}"

response = http.request(request)
puts response.read_body

{
  "time": "<string>",
  "success": true,
  "code": "<string>",
  "msg": "<string>",
  "confirmationCode": "<string>",
  "payload": [
    {
      "confirmationcode": "<string>"
    }
  ]
}

Ủy quyền

Authorization

string

header

bắt buộc

OAuth2 Implicit Grant

Nội dung

Request đăng ký nhận hàng vật chất (bên mua) - API 3.3.3 Giai đoạn FND -> LND

area

string

Khu vực nhận hàng: "HN" (Hà Nội) hoặc "HCM" (TP HCM)

contract

string

Mã hợp đồng kỳ hạn (VD: SIV0326)

quantity

integer<int32>

Số lượng lot đăng ký nhận (phải > 0)

string

Email liên hệ (chỉ điền nếu khác với thông tin trên tài khoản giao dịch)

phone

string

Số điện thoại liên hệ (chỉ điền nếu khác với thông tin trên tài khoản giao dịch)

authorization

object

Thông tin người uỷ quyền đến kho nhận Bạc (nếu có)

Show child attributes

Phản hồi

Wrapper response của MXV REST API cho các nghiệp vụ giao nhận hàng vật chất. Khác với MXVResponse<T> (dùng status/message/data), các API section 3.3/3.4 trả về success/code/msg/confirmationCode/payload.

time

string

Thời điểm server xử lý

success

boolean

true = thành công, false = lỗi

code

string

Mã kết quả: "0" = thành công

msg

string

Thông báo kết quả (VD: "[0]: Thành công!")

confirmationCode

string

Mã xác nhận đăng ký do MXV cấp (top-level field). End user cần lưu lại để dùng cho API huỷ và truy vấn.

payload

object[]

Dữ liệu chi tiết (array, mỗi phần tử chứa confirmationcode)

Show child attributes

Academy

Accounts

Admin

Authentication

Bond

Brokers

BrokerUsers

Chat

Events

Executions

Fmarket

HashTags

ICB

Individuals

Industries

Instruments

Investopedia

IR

Macro

Me

Monitoring

MXV

Orders

OrdersHistory

OrdersV2

Otp

Positions

PositionsV2

Posts

Reports

Rooms

Search

Symbols

Users

Đăng ký nhận hàng vật chất (bên mua)

Ủy quyền

Nội dung

Phản hồi