Submit Deposit Sender Travel Rule

curl --request POST \
  --url https://api-sandbox.uqpaytech.com/api/v1/ramp/wallet_address/deposit-sender \
  --header 'Content-Type: application/json' \
  --header 'x-auth-token: <api-key>' \
  --data '
{
  "source_address": "TLa2f6VPqDgRE67v1736s7bJ8Ray5wYjU7",
  "network": "TRX",
  "meta_data": {
    "wallet_type": "hosted",
    "address_party": "third_party",
    "beneficiary_information": {
      "entity_type": "individual",
      "first_name": "John",
      "last_name": "Doe",
      "company_name": "Acme Pte Ltd",
      "country": "sg",
      "city": "Singapore",
      "vasp_id": "I1QNLP",
      "vasp_name": "Binance",
      "id_type": "<string>",
      "id_primary": "<string>"
    }
  }
}
'

import requests

url = "https://api-sandbox.uqpaytech.com/api/v1/ramp/wallet_address/deposit-sender"

payload = {
    "source_address": "TLa2f6VPqDgRE67v1736s7bJ8Ray5wYjU7",
    "network": "TRX",
    "meta_data": {
        "wallet_type": "hosted",
        "address_party": "third_party",
        "beneficiary_information": {
            "entity_type": "individual",
            "first_name": "John",
            "last_name": "Doe",
            "company_name": "Acme Pte Ltd",
            "country": "sg",
            "city": "Singapore",
            "vasp_id": "I1QNLP",
            "vasp_name": "Binance",
            "id_type": "<string>",
            "id_primary": "<string>"
        }
    }
}
headers = {
    "x-auth-token": "<api-key>",
    "Content-Type": "application/json"
}

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

print(response.text)

const options = {
  method: 'POST',
  headers: {'x-auth-token': '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    source_address: 'TLa2f6VPqDgRE67v1736s7bJ8Ray5wYjU7',
    network: 'TRX',
    meta_data: {
      wallet_type: 'hosted',
      address_party: 'third_party',
      beneficiary_information: {
        entity_type: 'individual',
        first_name: 'John',
        last_name: 'Doe',
        company_name: 'Acme Pte Ltd',
        country: 'sg',
        city: 'Singapore',
        vasp_id: 'I1QNLP',
        vasp_name: 'Binance',
        id_type: '<string>',
        id_primary: '<string>'
      }
    }
  })
};

fetch('https://api-sandbox.uqpaytech.com/api/v1/ramp/wallet_address/deposit-sender', 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-sandbox.uqpaytech.com/api/v1/ramp/wallet_address/deposit-sender",
  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([
    'source_address' => 'TLa2f6VPqDgRE67v1736s7bJ8Ray5wYjU7',
    'network' => 'TRX',
    'meta_data' => [
        'wallet_type' => 'hosted',
        'address_party' => 'third_party',
        'beneficiary_information' => [
                'entity_type' => 'individual',
                'first_name' => 'John',
                'last_name' => 'Doe',
                'company_name' => 'Acme Pte Ltd',
                'country' => 'sg',
                'city' => 'Singapore',
                'vasp_id' => 'I1QNLP',
                'vasp_name' => 'Binance',
                'id_type' => '<string>',
                'id_primary' => '<string>'
        ]
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "x-auth-token: <api-key>"
  ],
]);

$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-sandbox.uqpaytech.com/api/v1/ramp/wallet_address/deposit-sender"

	payload := strings.NewReader("{\n  \"source_address\": \"TLa2f6VPqDgRE67v1736s7bJ8Ray5wYjU7\",\n  \"network\": \"TRX\",\n  \"meta_data\": {\n    \"wallet_type\": \"hosted\",\n    \"address_party\": \"third_party\",\n    \"beneficiary_information\": {\n      \"entity_type\": \"individual\",\n      \"first_name\": \"John\",\n      \"last_name\": \"Doe\",\n      \"company_name\": \"Acme Pte Ltd\",\n      \"country\": \"sg\",\n      \"city\": \"Singapore\",\n      \"vasp_id\": \"I1QNLP\",\n      \"vasp_name\": \"Binance\",\n      \"id_type\": \"<string>\",\n      \"id_primary\": \"<string>\"\n    }\n  }\n}")

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

	req.Header.Add("x-auth-token", "<api-key>")
	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-sandbox.uqpaytech.com/api/v1/ramp/wallet_address/deposit-sender")
  .header("x-auth-token", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"source_address\": \"TLa2f6VPqDgRE67v1736s7bJ8Ray5wYjU7\",\n  \"network\": \"TRX\",\n  \"meta_data\": {\n    \"wallet_type\": \"hosted\",\n    \"address_party\": \"third_party\",\n    \"beneficiary_information\": {\n      \"entity_type\": \"individual\",\n      \"first_name\": \"John\",\n      \"last_name\": \"Doe\",\n      \"company_name\": \"Acme Pte Ltd\",\n      \"country\": \"sg\",\n      \"city\": \"Singapore\",\n      \"vasp_id\": \"I1QNLP\",\n      \"vasp_name\": \"Binance\",\n      \"id_type\": \"<string>\",\n      \"id_primary\": \"<string>\"\n    }\n  }\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api-sandbox.uqpaytech.com/api/v1/ramp/wallet_address/deposit-sender")

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

request = Net::HTTP::Post.new(url)
request["x-auth-token"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"source_address\": \"TLa2f6VPqDgRE67v1736s7bJ8Ray5wYjU7\",\n  \"network\": \"TRX\",\n  \"meta_data\": {\n    \"wallet_type\": \"hosted\",\n    \"address_party\": \"third_party\",\n    \"beneficiary_information\": {\n      \"entity_type\": \"individual\",\n      \"first_name\": \"John\",\n      \"last_name\": \"Doe\",\n      \"company_name\": \"Acme Pte Ltd\",\n      \"country\": \"sg\",\n      \"city\": \"Singapore\",\n      \"vasp_id\": \"I1QNLP\",\n      \"vasp_name\": \"Binance\",\n      \"id_type\": \"<string>\",\n      \"id_primary\": \"<string>\"\n    }\n  }\n}"

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

{
  "code": 200,
  "message": "Success",
  "data": null
}

Travel Rule

Submit Deposit Sender Travel Rule

为一笔到账充值提交发起方（来源方）的 Travel Rule 数据。当收到 need_travel_rule=true 的充值通知时调用；受理后，该笔充值以及后续来自相同来源地址的充值即可继续处理。充值来源条目与提现地址簿分开存放——查询时传 address_kind=deposit_sender。以相同的 source_address 和 network 再次调用即为更新已有条目。 Stablecoin Account API 发布方免责声明

POST

ramp

wallet_address

deposit-sender

Submit Deposit Sender Travel Rule

curl --request POST \
  --url https://api-sandbox.uqpaytech.com/api/v1/ramp/wallet_address/deposit-sender \
  --header 'Content-Type: application/json' \
  --header 'x-auth-token: <api-key>' \
  --data '
{
  "source_address": "TLa2f6VPqDgRE67v1736s7bJ8Ray5wYjU7",
  "network": "TRX",
  "meta_data": {
    "wallet_type": "hosted",
    "address_party": "third_party",
    "beneficiary_information": {
      "entity_type": "individual",
      "first_name": "John",
      "last_name": "Doe",
      "company_name": "Acme Pte Ltd",
      "country": "sg",
      "city": "Singapore",
      "vasp_id": "I1QNLP",
      "vasp_name": "Binance",
      "id_type": "<string>",
      "id_primary": "<string>"
    }
  }
}
'

import requests

url = "https://api-sandbox.uqpaytech.com/api/v1/ramp/wallet_address/deposit-sender"

payload = {
    "source_address": "TLa2f6VPqDgRE67v1736s7bJ8Ray5wYjU7",
    "network": "TRX",
    "meta_data": {
        "wallet_type": "hosted",
        "address_party": "third_party",
        "beneficiary_information": {
            "entity_type": "individual",
            "first_name": "John",
            "last_name": "Doe",
            "company_name": "Acme Pte Ltd",
            "country": "sg",
            "city": "Singapore",
            "vasp_id": "I1QNLP",
            "vasp_name": "Binance",
            "id_type": "<string>",
            "id_primary": "<string>"
        }
    }
}
headers = {
    "x-auth-token": "<api-key>",
    "Content-Type": "application/json"
}

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

print(response.text)

const options = {
  method: 'POST',
  headers: {'x-auth-token': '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    source_address: 'TLa2f6VPqDgRE67v1736s7bJ8Ray5wYjU7',
    network: 'TRX',
    meta_data: {
      wallet_type: 'hosted',
      address_party: 'third_party',
      beneficiary_information: {
        entity_type: 'individual',
        first_name: 'John',
        last_name: 'Doe',
        company_name: 'Acme Pte Ltd',
        country: 'sg',
        city: 'Singapore',
        vasp_id: 'I1QNLP',
        vasp_name: 'Binance',
        id_type: '<string>',
        id_primary: '<string>'
      }
    }
  })
};

fetch('https://api-sandbox.uqpaytech.com/api/v1/ramp/wallet_address/deposit-sender', 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-sandbox.uqpaytech.com/api/v1/ramp/wallet_address/deposit-sender",
  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([
    'source_address' => 'TLa2f6VPqDgRE67v1736s7bJ8Ray5wYjU7',
    'network' => 'TRX',
    'meta_data' => [
        'wallet_type' => 'hosted',
        'address_party' => 'third_party',
        'beneficiary_information' => [
                'entity_type' => 'individual',
                'first_name' => 'John',
                'last_name' => 'Doe',
                'company_name' => 'Acme Pte Ltd',
                'country' => 'sg',
                'city' => 'Singapore',
                'vasp_id' => 'I1QNLP',
                'vasp_name' => 'Binance',
                'id_type' => '<string>',
                'id_primary' => '<string>'
        ]
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "x-auth-token: <api-key>"
  ],
]);

$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-sandbox.uqpaytech.com/api/v1/ramp/wallet_address/deposit-sender"

	payload := strings.NewReader("{\n  \"source_address\": \"TLa2f6VPqDgRE67v1736s7bJ8Ray5wYjU7\",\n  \"network\": \"TRX\",\n  \"meta_data\": {\n    \"wallet_type\": \"hosted\",\n    \"address_party\": \"third_party\",\n    \"beneficiary_information\": {\n      \"entity_type\": \"individual\",\n      \"first_name\": \"John\",\n      \"last_name\": \"Doe\",\n      \"company_name\": \"Acme Pte Ltd\",\n      \"country\": \"sg\",\n      \"city\": \"Singapore\",\n      \"vasp_id\": \"I1QNLP\",\n      \"vasp_name\": \"Binance\",\n      \"id_type\": \"<string>\",\n      \"id_primary\": \"<string>\"\n    }\n  }\n}")

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

	req.Header.Add("x-auth-token", "<api-key>")
	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-sandbox.uqpaytech.com/api/v1/ramp/wallet_address/deposit-sender")
  .header("x-auth-token", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"source_address\": \"TLa2f6VPqDgRE67v1736s7bJ8Ray5wYjU7\",\n  \"network\": \"TRX\",\n  \"meta_data\": {\n    \"wallet_type\": \"hosted\",\n    \"address_party\": \"third_party\",\n    \"beneficiary_information\": {\n      \"entity_type\": \"individual\",\n      \"first_name\": \"John\",\n      \"last_name\": \"Doe\",\n      \"company_name\": \"Acme Pte Ltd\",\n      \"country\": \"sg\",\n      \"city\": \"Singapore\",\n      \"vasp_id\": \"I1QNLP\",\n      \"vasp_name\": \"Binance\",\n      \"id_type\": \"<string>\",\n      \"id_primary\": \"<string>\"\n    }\n  }\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api-sandbox.uqpaytech.com/api/v1/ramp/wallet_address/deposit-sender")

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

request = Net::HTTP::Post.new(url)
request["x-auth-token"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"source_address\": \"TLa2f6VPqDgRE67v1736s7bJ8Ray5wYjU7\",\n  \"network\": \"TRX\",\n  \"meta_data\": {\n    \"wallet_type\": \"hosted\",\n    \"address_party\": \"third_party\",\n    \"beneficiary_information\": {\n      \"entity_type\": \"individual\",\n      \"first_name\": \"John\",\n      \"last_name\": \"Doe\",\n      \"company_name\": \"Acme Pte Ltd\",\n      \"country\": \"sg\",\n      \"city\": \"Singapore\",\n      \"vasp_id\": \"I1QNLP\",\n      \"vasp_name\": \"Binance\",\n      \"id_type\": \"<string>\",\n      \"id_primary\": \"<string>\"\n    }\n  }\n}"

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

{
  "code": 200,
  "message": "Success",
  "data": null
}

授权

x-auth-token

string

header

必填

UQPay 提供的用于登录的 API Token。

请求头

x-on-behalf-of

string

指定代表哪个子账户发起请求。应设置为 account_id，可通过 List Connected Accounts 接口获取。若省略或为空，则请求以主账户身份执行。更多信息参见 Connected Accounts。

x-idempotency-key

string<uuid>

用于保持操作幂等性的唯一标识符（UUID），确保同一操作的重复执行不会产生非预期的影响或重复。在网络错误、重试或失败的情况下，它有助于保持数据一致性。

请求体

application/json

source_address

string

必填

充值来源地址。使用充值通知里的 from_address，须与该笔充值一致。

示例:

"TLa2f6VPqDgRE67v1736s7bJ8Ray5wYjU7"

network

string

必填

该笔充值的网络。使用充值通知里的 network。

示例:

"TRX"

meta_data

object

必填

充值发起方（来源方）的 Travel Rule 数据。

Show child attributes

响应

200 - application/json

成功受理充值来源 Travel Rule

code

integer

必填

示例:

200

message

string

必填

示例:

"Success"

data

any | null

必填

始终为 null；成功响应即表示已受理提交。

示例:

null

Update address book List vasps