Import Sumsub reusable KYC share token

curl --request POST \
  --url https://api.pods.finance/api/v1/kyc/sumsub-share-token \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "shareToken": "SUMSUB_SHARE_TOKEN",
  "sumsubApplicantId": "6a3502bf7fee2fab5377cb1e",
  "email": "[email protected]",
  "walletAddress": "EXYhCNamLPFfSMekSn7Lzc2cP32aZpRa7ok5gErdJzcj",
  "cpf": "52998224725",
  "taxId": "FX1234567",
  "taxIdCountry": "BRA"
}
'

import requests

url = "https://api.pods.finance/api/v1/kyc/sumsub-share-token"

payload = {
    "shareToken": "SUMSUB_SHARE_TOKEN",
    "sumsubApplicantId": "6a3502bf7fee2fab5377cb1e",
    "email": "[email protected]",
    "walletAddress": "EXYhCNamLPFfSMekSn7Lzc2cP32aZpRa7ok5gErdJzcj",
    "cpf": "52998224725",
    "taxId": "FX1234567",
    "taxIdCountry": "BRA"
}
headers = {
    "x-api-key": "<api-key>",
    "Content-Type": "application/json"
}

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

print(response.text)

const options = {
  method: 'POST',
  headers: {'x-api-key': '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    shareToken: 'SUMSUB_SHARE_TOKEN',
    sumsubApplicantId: '6a3502bf7fee2fab5377cb1e',
    email: '[email protected]',
    walletAddress: 'EXYhCNamLPFfSMekSn7Lzc2cP32aZpRa7ok5gErdJzcj',
    cpf: '52998224725',
    taxId: 'FX1234567',
    taxIdCountry: 'BRA'
  })
};

fetch('https://api.pods.finance/api/v1/kyc/sumsub-share-token', 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.pods.finance/api/v1/kyc/sumsub-share-token",
  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([
    'shareToken' => 'SUMSUB_SHARE_TOKEN',
    'sumsubApplicantId' => '6a3502bf7fee2fab5377cb1e',
    'email' => '[email protected]',
    'walletAddress' => 'EXYhCNamLPFfSMekSn7Lzc2cP32aZpRa7ok5gErdJzcj',
    'cpf' => '52998224725',
    'taxId' => 'FX1234567',
    'taxIdCountry' => 'BRA'
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "x-api-key: <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.pods.finance/api/v1/kyc/sumsub-share-token"

	payload := strings.NewReader("{\n  \"shareToken\": \"SUMSUB_SHARE_TOKEN\",\n  \"sumsubApplicantId\": \"6a3502bf7fee2fab5377cb1e\",\n  \"email\": \"[email protected]\",\n  \"walletAddress\": \"EXYhCNamLPFfSMekSn7Lzc2cP32aZpRa7ok5gErdJzcj\",\n  \"cpf\": \"52998224725\",\n  \"taxId\": \"FX1234567\",\n  \"taxIdCountry\": \"BRA\"\n}")

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

	req.Header.Add("x-api-key", "<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.pods.finance/api/v1/kyc/sumsub-share-token")
  .header("x-api-key", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"shareToken\": \"SUMSUB_SHARE_TOKEN\",\n  \"sumsubApplicantId\": \"6a3502bf7fee2fab5377cb1e\",\n  \"email\": \"[email protected]\",\n  \"walletAddress\": \"EXYhCNamLPFfSMekSn7Lzc2cP32aZpRa7ok5gErdJzcj\",\n  \"cpf\": \"52998224725\",\n  \"taxId\": \"FX1234567\",\n  \"taxIdCountry\": \"BRA\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.pods.finance/api/v1/kyc/sumsub-share-token")

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

request = Net::HTTP::Post.new(url)
request["x-api-key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"shareToken\": \"SUMSUB_SHARE_TOKEN\",\n  \"sumsubApplicantId\": \"6a3502bf7fee2fab5377cb1e\",\n  \"email\": \"[email protected]\",\n  \"walletAddress\": \"EXYhCNamLPFfSMekSn7Lzc2cP32aZpRa7ok5gErdJzcj\",\n  \"cpf\": \"52998224725\",\n  \"taxId\": \"FX1234567\",\n  \"taxIdCountry\": \"BRA\"\n}"

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

{
  "kycUserId": "550e8400-e29b-41d4-a716-446655440000",
  "status": "provider_pending"
}

{
  "error": {
    "code": "QUOTE_NOT_FOUND",
    "message": "Quote not found or expired"
  }
}

{
  "error": {
    "code": "QUOTE_NOT_FOUND",
    "message": "Quote not found or expired"
  }
}

{
  "error": {
    "code": "QUOTE_NOT_FOUND",
    "message": "Quote not found or expired"
  }
}

{
  "error": {
    "code": "QUOTE_NOT_FOUND",
    "message": "Quote not found or expired"
  }
}

Ramp

Import Sumsub reusable KYC share token

Submit a fresh Sumsub reusable KYC share token after Sumsub approves the applicant. Send the CPF whenever it is known; supply taxId instead when the applicant was verified with a document that carries no CPF, such as a passport. Pods validates the identifier, stores only a salted hash plus the last four digits, and revalidates any unique approved Avenia identity already associated with it. An approved match is reused in a new customer-scoped profile without consuming the fresh token. Otherwise, Pods creates or reuses the customer profile and Avenia subaccount, imports the token into Avenia, and returns a Pods-generated kycUserId. A submission without a CPF cannot be matched against identities approved under one, so it may be rejected downstream by Avenia as a duplicate tax id.

POST

api

kyc

sumsub-share-token

Import Sumsub reusable KYC share token

curl --request POST \
  --url https://api.pods.finance/api/v1/kyc/sumsub-share-token \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "shareToken": "SUMSUB_SHARE_TOKEN",
  "sumsubApplicantId": "6a3502bf7fee2fab5377cb1e",
  "email": "[email protected]",
  "walletAddress": "EXYhCNamLPFfSMekSn7Lzc2cP32aZpRa7ok5gErdJzcj",
  "cpf": "52998224725",
  "taxId": "FX1234567",
  "taxIdCountry": "BRA"
}
'

import requests

url = "https://api.pods.finance/api/v1/kyc/sumsub-share-token"

payload = {
    "shareToken": "SUMSUB_SHARE_TOKEN",
    "sumsubApplicantId": "6a3502bf7fee2fab5377cb1e",
    "email": "[email protected]",
    "walletAddress": "EXYhCNamLPFfSMekSn7Lzc2cP32aZpRa7ok5gErdJzcj",
    "cpf": "52998224725",
    "taxId": "FX1234567",
    "taxIdCountry": "BRA"
}
headers = {
    "x-api-key": "<api-key>",
    "Content-Type": "application/json"
}

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

print(response.text)

const options = {
  method: 'POST',
  headers: {'x-api-key': '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    shareToken: 'SUMSUB_SHARE_TOKEN',
    sumsubApplicantId: '6a3502bf7fee2fab5377cb1e',
    email: '[email protected]',
    walletAddress: 'EXYhCNamLPFfSMekSn7Lzc2cP32aZpRa7ok5gErdJzcj',
    cpf: '52998224725',
    taxId: 'FX1234567',
    taxIdCountry: 'BRA'
  })
};

fetch('https://api.pods.finance/api/v1/kyc/sumsub-share-token', 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.pods.finance/api/v1/kyc/sumsub-share-token",
  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([
    'shareToken' => 'SUMSUB_SHARE_TOKEN',
    'sumsubApplicantId' => '6a3502bf7fee2fab5377cb1e',
    'email' => '[email protected]',
    'walletAddress' => 'EXYhCNamLPFfSMekSn7Lzc2cP32aZpRa7ok5gErdJzcj',
    'cpf' => '52998224725',
    'taxId' => 'FX1234567',
    'taxIdCountry' => 'BRA'
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "x-api-key: <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.pods.finance/api/v1/kyc/sumsub-share-token"

	payload := strings.NewReader("{\n  \"shareToken\": \"SUMSUB_SHARE_TOKEN\",\n  \"sumsubApplicantId\": \"6a3502bf7fee2fab5377cb1e\",\n  \"email\": \"[email protected]\",\n  \"walletAddress\": \"EXYhCNamLPFfSMekSn7Lzc2cP32aZpRa7ok5gErdJzcj\",\n  \"cpf\": \"52998224725\",\n  \"taxId\": \"FX1234567\",\n  \"taxIdCountry\": \"BRA\"\n}")

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

	req.Header.Add("x-api-key", "<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.pods.finance/api/v1/kyc/sumsub-share-token")
  .header("x-api-key", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"shareToken\": \"SUMSUB_SHARE_TOKEN\",\n  \"sumsubApplicantId\": \"6a3502bf7fee2fab5377cb1e\",\n  \"email\": \"[email protected]\",\n  \"walletAddress\": \"EXYhCNamLPFfSMekSn7Lzc2cP32aZpRa7ok5gErdJzcj\",\n  \"cpf\": \"52998224725\",\n  \"taxId\": \"FX1234567\",\n  \"taxIdCountry\": \"BRA\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.pods.finance/api/v1/kyc/sumsub-share-token")

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

request = Net::HTTP::Post.new(url)
request["x-api-key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"shareToken\": \"SUMSUB_SHARE_TOKEN\",\n  \"sumsubApplicantId\": \"6a3502bf7fee2fab5377cb1e\",\n  \"email\": \"[email protected]\",\n  \"walletAddress\": \"EXYhCNamLPFfSMekSn7Lzc2cP32aZpRa7ok5gErdJzcj\",\n  \"cpf\": \"52998224725\",\n  \"taxId\": \"FX1234567\",\n  \"taxIdCountry\": \"BRA\"\n}"

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

{
  "kycUserId": "550e8400-e29b-41d4-a716-446655440000",
  "status": "provider_pending"
}

{
  "error": {
    "code": "QUOTE_NOT_FOUND",
    "message": "Quote not found or expired"
  }
}

{
  "error": {
    "code": "QUOTE_NOT_FOUND",
    "message": "Quote not found or expired"
  }
}

{
  "error": {
    "code": "QUOTE_NOT_FOUND",
    "message": "Quote not found or expired"
  }
}

{
  "error": {
    "code": "QUOTE_NOT_FOUND",
    "message": "Quote not found or expired"
  }
}

Authorizations

x-api-key

string

header

required

API key for authentication. Obtain from your Pods dashboard.

Body

application/json

Reusable KYC share token import payload. At least one of cpf or taxId is required; sending both is allowed and cpf is what identity matching uses.

Fresh Sumsub reusable KYC share token generated for the Avenia recipient

Example:

"SUMSUB_SHARE_TOKEN"

sumsubApplicantId

string

required

Unique Sumsub applicant id from the approved applicantReviewed webhook. Pods uses it for customer-scoped idempotency.

Example:

"6a3502bf7fee2fab5377cb1e"

string<email>

required

Applicant email

Example:

"[email protected]"

walletAddress

string

required

Applicant wallet. Checksummed EVM address or Solana public key.

Example:

"EXYhCNamLPFfSMekSn7Lzc2cP32aZpRa7ok5gErdJzcj"

cpf

string

Brazilian CPF. Optional, and accepted alongside any taxIdCountry — a foreign national resident in Brazil holds both. Send it whenever it is known: it is what lets Pods reuse an already-approved identity instead of creating a duplicate at Avenia, and it is what opens the BRL rail. Pods stores only a salted hash and the last four digits.

Example:

"52998224725"

taxId

string

Tax identifier for an applicant verified with a document that carries no CPF, such as a passport, or whose jurisdiction is not Brazil. Supply either cpf or taxId; when taxIdCountry is BRA and the value is itself a valid CPF, Pods treats it as one. Pods stores only a salted hash and the last four digits.

Example:

"FX1234567"

taxIdCountry

string

ISO 3166-1 alpha-3 jurisdiction of the tax id (for example BRA or USA). Required whenever the tax id is not a CPF; it is inferred as BRA only when a cpf is sent or the taxId itself passes the CPF check digits. The country is part of the stored identity hash, so the same digits under two jurisdictions are two different identities — and a profile submitted under the wrong country cannot be corrected afterwards. A profile without a CPF does not receive the BRL ramp; unlock USD with POST /api/v1/kyc/currency-unlock.

Required string length: 3

Example:

"BRA"

Response

KYC token import submitted or approved Avenia identity reused

KYC import submission result

kycUserId

string<uuid>

required

Pods-generated public KYC user id

Example:

"550e8400-e29b-41d4-a716-446655440000"

status

enum<string>

required

Normalized Pods KYC status

Available options:

created,

provider_pending,

approved,

rejected,

rejected_retryable,

blocked

Example:

"provider_pending"

Overview

Health

Swap

Tracking

Strategies

Ondo

Tokens

Transfer

Wallets

Smart Account

Ramp

Import Sumsub reusable KYC share token

Authorizations

Body

Response