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 '
{
  "cpf": "52998224725",
  "shareToken": "SUMSUB_SHARE_TOKEN",
  "sumsubApplicantId": "6a3502bf7fee2fab5377cb1e",
  "email": "[email protected]",
  "walletAddress": "0xb794F5eA0ba39494cE839613fffBA74279579268"
}
'

import requests

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

payload = {
    "cpf": "52998224725",
    "shareToken": "SUMSUB_SHARE_TOKEN",
    "sumsubApplicantId": "6a3502bf7fee2fab5377cb1e",
    "email": "[email protected]",
    "walletAddress": "0xb794F5eA0ba39494cE839613fffBA74279579268"
}
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({
    cpf: '52998224725',
    shareToken: 'SUMSUB_SHARE_TOKEN',
    sumsubApplicantId: '6a3502bf7fee2fab5377cb1e',
    email: '[email protected]',
    walletAddress: '0xb794F5eA0ba39494cE839613fffBA74279579268'
  })
};

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([
    'cpf' => '52998224725',
    'shareToken' => 'SUMSUB_SHARE_TOKEN',
    'sumsubApplicantId' => '6a3502bf7fee2fab5377cb1e',
    'email' => '[email protected]',
    'walletAddress' => '0xb794F5eA0ba39494cE839613fffBA74279579268'
  ]),
  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  \"cpf\": \"52998224725\",\n  \"shareToken\": \"SUMSUB_SHARE_TOKEN\",\n  \"sumsubApplicantId\": \"6a3502bf7fee2fab5377cb1e\",\n  \"email\": \"[email protected]\",\n  \"walletAddress\": \"0xb794F5eA0ba39494cE839613fffBA74279579268\"\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  \"cpf\": \"52998224725\",\n  \"shareToken\": \"SUMSUB_SHARE_TOKEN\",\n  \"sumsubApplicantId\": \"6a3502bf7fee2fab5377cb1e\",\n  \"email\": \"[email protected]\",\n  \"walletAddress\": \"0xb794F5eA0ba39494cE839613fffBA74279579268\"\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  \"cpf\": \"52998224725\",\n  \"shareToken\": \"SUMSUB_SHARE_TOKEN\",\n  \"sumsubApplicantId\": \"6a3502bf7fee2fab5377cb1e\",\n  \"email\": \"[email protected]\",\n  \"walletAddress\": \"0xb794F5eA0ba39494cE839613fffBA74279579268\"\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"
  }
}

KYC

Import Sumsub reusable KYC share token

Submit a fresh Sumsub reusable KYC share token after Sumsub approves the applicant. Pods validates the CPF, stores only a salted hash plus the last four digits, and revalidates any unique approved Avenia identity already associated with the same CPF. 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.

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 '
{
  "cpf": "52998224725",
  "shareToken": "SUMSUB_SHARE_TOKEN",
  "sumsubApplicantId": "6a3502bf7fee2fab5377cb1e",
  "email": "[email protected]",
  "walletAddress": "0xb794F5eA0ba39494cE839613fffBA74279579268"
}
'

import requests

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

payload = {
    "cpf": "52998224725",
    "shareToken": "SUMSUB_SHARE_TOKEN",
    "sumsubApplicantId": "6a3502bf7fee2fab5377cb1e",
    "email": "[email protected]",
    "walletAddress": "0xb794F5eA0ba39494cE839613fffBA74279579268"
}
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({
    cpf: '52998224725',
    shareToken: 'SUMSUB_SHARE_TOKEN',
    sumsubApplicantId: '6a3502bf7fee2fab5377cb1e',
    email: '[email protected]',
    walletAddress: '0xb794F5eA0ba39494cE839613fffBA74279579268'
  })
};

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([
    'cpf' => '52998224725',
    'shareToken' => 'SUMSUB_SHARE_TOKEN',
    'sumsubApplicantId' => '6a3502bf7fee2fab5377cb1e',
    'email' => '[email protected]',
    'walletAddress' => '0xb794F5eA0ba39494cE839613fffBA74279579268'
  ]),
  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  \"cpf\": \"52998224725\",\n  \"shareToken\": \"SUMSUB_SHARE_TOKEN\",\n  \"sumsubApplicantId\": \"6a3502bf7fee2fab5377cb1e\",\n  \"email\": \"[email protected]\",\n  \"walletAddress\": \"0xb794F5eA0ba39494cE839613fffBA74279579268\"\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  \"cpf\": \"52998224725\",\n  \"shareToken\": \"SUMSUB_SHARE_TOKEN\",\n  \"sumsubApplicantId\": \"6a3502bf7fee2fab5377cb1e\",\n  \"email\": \"[email protected]\",\n  \"walletAddress\": \"0xb794F5eA0ba39494cE839613fffBA74279579268\"\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  \"cpf\": \"52998224725\",\n  \"shareToken\": \"SUMSUB_SHARE_TOKEN\",\n  \"sumsubApplicantId\": \"6a3502bf7fee2fab5377cb1e\",\n  \"email\": \"[email protected]\",\n  \"walletAddress\": \"0xb794F5eA0ba39494cE839613fffBA74279579268\"\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

cpf

string

required

Brazilian CPF used to match an existing approved Avenia identity. Pods stores only a salted hash and the last four digits.

Example:

"52998224725"

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 EVM wallet address

Example:

"0xb794F5eA0ba39494cE839613fffBA74279579268"

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"

Create or retrieve smart account

Create BigDataCorp KYC iframe session

Overview

Health

Swap

Tracking

Strategies

Ondo

Tokens

Transfer

Wallets

Smart Account

KYC

Import Sumsub reusable KYC share token

Authorizations

Body

Response