Register Payin Account Asset

curl --request POST \
  --url https://api.dfns.io/payins/accounts/assets \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'X-DFNS-USERACTION: <api-key>' \
  --data '
{
  "provider": "Borderless",
  "borderlessAccountId": "<string>",
  "walletId": "wa-5pfuu-9euek-h0odgb6snva8ph3k",
  "asset": {
    "kind": "Erc20",
    "contract": "<string>"
  }
}
'

import requests

url = "https://api.dfns.io/payins/accounts/assets"

payload = {
    "provider": "Borderless",
    "borderlessAccountId": "<string>",
    "walletId": "wa-5pfuu-9euek-h0odgb6snva8ph3k",
    "asset": {
        "kind": "Erc20",
        "contract": "<string>"
    }
}
headers = {
    "Authorization": "Bearer <token>",
    "X-DFNS-USERACTION": "<api-key>",
    "Content-Type": "application/json"
}

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

print(response.text)

const options = {
  method: 'POST',
  headers: {
    Authorization: 'Bearer <token>',
    'X-DFNS-USERACTION': '<api-key>',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    provider: 'Borderless',
    borderlessAccountId: '<string>',
    walletId: 'wa-5pfuu-9euek-h0odgb6snva8ph3k',
    asset: {kind: 'Erc20', contract: '<string>'}
  })
};

fetch('https://api.dfns.io/payins/accounts/assets', 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.dfns.io/payins/accounts/assets",
  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([
    'provider' => 'Borderless',
    'borderlessAccountId' => '<string>',
    'walletId' => 'wa-5pfuu-9euek-h0odgb6snva8ph3k',
    'asset' => [
        'kind' => 'Erc20',
        'contract' => '<string>'
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json",
    "X-DFNS-USERACTION: <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.dfns.io/payins/accounts/assets"

	payload := strings.NewReader("{\n  \"provider\": \"Borderless\",\n  \"borderlessAccountId\": \"<string>\",\n  \"walletId\": \"wa-5pfuu-9euek-h0odgb6snva8ph3k\",\n  \"asset\": {\n    \"kind\": \"Erc20\",\n    \"contract\": \"<string>\"\n  }\n}")

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

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("X-DFNS-USERACTION", "<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.dfns.io/payins/accounts/assets")
  .header("Authorization", "Bearer <token>")
  .header("X-DFNS-USERACTION", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"provider\": \"Borderless\",\n  \"borderlessAccountId\": \"<string>\",\n  \"walletId\": \"wa-5pfuu-9euek-h0odgb6snva8ph3k\",\n  \"asset\": {\n    \"kind\": \"Erc20\",\n    \"contract\": \"<string>\"\n  }\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.dfns.io/payins/accounts/assets")

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

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["X-DFNS-USERACTION"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"provider\": \"Borderless\",\n  \"borderlessAccountId\": \"<string>\",\n  \"walletId\": \"wa-5pfuu-9euek-h0odgb6snva8ph3k\",\n  \"asset\": {\n    \"kind\": \"Erc20\",\n    \"contract\": \"<string>\"\n  }\n}"

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

{
  "accountId": "<string>",
  "assets": [
    {
      "asset": "<string>",
      "address": "<string>"
    }
  ],
  "name": "<string>"
}

POST

payins

accounts

assets

curl --request POST \
  --url https://api.dfns.io/payins/accounts/assets \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'X-DFNS-USERACTION: <api-key>' \
  --data '
{
  "provider": "Borderless",
  "borderlessAccountId": "<string>",
  "walletId": "wa-5pfuu-9euek-h0odgb6snva8ph3k",
  "asset": {
    "kind": "Erc20",
    "contract": "<string>"
  }
}
'

import requests

url = "https://api.dfns.io/payins/accounts/assets"

payload = {
    "provider": "Borderless",
    "borderlessAccountId": "<string>",
    "walletId": "wa-5pfuu-9euek-h0odgb6snva8ph3k",
    "asset": {
        "kind": "Erc20",
        "contract": "<string>"
    }
}
headers = {
    "Authorization": "Bearer <token>",
    "X-DFNS-USERACTION": "<api-key>",
    "Content-Type": "application/json"
}

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

print(response.text)

const options = {
  method: 'POST',
  headers: {
    Authorization: 'Bearer <token>',
    'X-DFNS-USERACTION': '<api-key>',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    provider: 'Borderless',
    borderlessAccountId: '<string>',
    walletId: 'wa-5pfuu-9euek-h0odgb6snva8ph3k',
    asset: {kind: 'Erc20', contract: '<string>'}
  })
};

fetch('https://api.dfns.io/payins/accounts/assets', 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.dfns.io/payins/accounts/assets",
  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([
    'provider' => 'Borderless',
    'borderlessAccountId' => '<string>',
    'walletId' => 'wa-5pfuu-9euek-h0odgb6snva8ph3k',
    'asset' => [
        'kind' => 'Erc20',
        'contract' => '<string>'
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json",
    "X-DFNS-USERACTION: <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.dfns.io/payins/accounts/assets"

	payload := strings.NewReader("{\n  \"provider\": \"Borderless\",\n  \"borderlessAccountId\": \"<string>\",\n  \"walletId\": \"wa-5pfuu-9euek-h0odgb6snva8ph3k\",\n  \"asset\": {\n    \"kind\": \"Erc20\",\n    \"contract\": \"<string>\"\n  }\n}")

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

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("X-DFNS-USERACTION", "<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.dfns.io/payins/accounts/assets")
  .header("Authorization", "Bearer <token>")
  .header("X-DFNS-USERACTION", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"provider\": \"Borderless\",\n  \"borderlessAccountId\": \"<string>\",\n  \"walletId\": \"wa-5pfuu-9euek-h0odgb6snva8ph3k\",\n  \"asset\": {\n    \"kind\": \"Erc20\",\n    \"contract\": \"<string>\"\n  }\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.dfns.io/payins/accounts/assets")

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

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["X-DFNS-USERACTION"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"provider\": \"Borderless\",\n  \"borderlessAccountId\": \"<string>\",\n  \"walletId\": \"wa-5pfuu-9euek-h0odgb6snva8ph3k\",\n  \"asset\": {\n    \"kind\": \"Erc20\",\n    \"contract\": \"<string>\"\n  }\n}"

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

{
  "accountId": "<string>",
  "assets": [
    {
      "asset": "<string>",
      "address": "<string>"
    }
  ],
  "name": "<string>"
}

Authentication

✅ Organization User (CustomerEmployee)
❌ Delegated User (EndUser)
✅ Service Account

Required Permissions

Payins:Create: Always required.

Authorizations

Authorization

string

header

required

Bearer Token: Used to authenticate API requests. More details how to generate the token: Authentication flows

X-DFNS-USERACTION

string

header

required

User Action Signature: Used to sign the change-inducing API requests. More details how to generate the token: User Action Signing flows

Body

application/json

provider

enum<string>

required

Available options:

Borderless

borderlessAccountId

string

required

The Borderless account to register the asset on.

walletId

string

required

The wallet whose address becomes the delivery destination for the asset.

Required string length: 1 - 64

Pattern: ^wa-[a-z0-9]{5}-[a-z0-9]{5}-[a-z0-9]{14,16}$

Example:

"wa-5pfuu-9euek-h0odgb6snva8ph3k"

asset

ERC-20 Asset · object

required

The asset to deliver on-chain. Must be supported by Borderless on the wallet network.

ERC-20 Asset
SPL/SPL-2022 Asset

Show child attributes

Response

200 - application/json

Success

accountId

string

required

The provider's account id.

assets

object[]

required

The assets registered on the account, with their destination addresses.

Show child attributes

name

string

The account name, when the provider has one.

Last modified on September 11, 2026

API Authorization

Identity & Access Management

Wallets & Transactions

Management

Webhooks

Authentication

Required Permissions

Authorizations

Body

Response

​Authentication

​Required Permissions

Authorizations

Body

Response

Authentication

Required Permissions