Open the selfie of a held payout
curl --request POST \
--url https://api.sandbox.busha.so/v1/transfers/{id}/liveness \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.sandbox.busha.so/v1/transfers/{id}/liveness"
headers = {"Authorization": "Bearer <token>"}
response = requests.post(url, headers=headers)
print(response.text)const options = {method: 'POST', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.sandbox.busha.so/v1/transfers/{id}/liveness', 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.busha.so/v1/transfers/{id}/liveness",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.sandbox.busha.so/v1/transfers/{id}/liveness"
req, _ := http.NewRequest("POST", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
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.busha.so/v1/transfers/{id}/liveness")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.sandbox.busha.so/v1/transfers/{id}/liveness")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"status": "success",
"message": "message for success",
"data": {
"transfer_id": "bus_123456789",
"status": "waiting",
"access_token": "_act-sbx-b8ebfb63-5f24-4b89-9c08-000000000000",
"level_name": "liveness-confirmation",
"expires_at": "2026-11-15T15:04:05Z"
}
}Transfers
Open the selfie of a held payout
A payout whose transfer carries liveness.required: true waits for the customer’s selfie before any money moves.
This starts the selfie and answers the token Sumsub’s native SDK runs it with, with its level and when it runs
out; call it again for a new token. The customer has 30 minutes from when the payout was held. A selfie that
passes sends the payout; one that fails, or none taken in time, cancels it, and the transfer carries a
notice saying why. Once the selfie no longer waits, this answers its status and no token. 404 when the
transfer does not wait on a selfie; 422 liveness_check_unavailable when Sumsub has no face on file to
match, which only support can then release.
POST
/
v1
/
transfers
/
{id}
/
liveness
Open the selfie of a held payout
curl --request POST \
--url https://api.sandbox.busha.so/v1/transfers/{id}/liveness \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.sandbox.busha.so/v1/transfers/{id}/liveness"
headers = {"Authorization": "Bearer <token>"}
response = requests.post(url, headers=headers)
print(response.text)const options = {method: 'POST', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.sandbox.busha.so/v1/transfers/{id}/liveness', 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.busha.so/v1/transfers/{id}/liveness",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.sandbox.busha.so/v1/transfers/{id}/liveness"
req, _ := http.NewRequest("POST", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
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.busha.so/v1/transfers/{id}/liveness")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.sandbox.busha.so/v1/transfers/{id}/liveness")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"status": "success",
"message": "message for success",
"data": {
"transfer_id": "bus_123456789",
"status": "waiting",
"access_token": "_act-sbx-b8ebfb63-5f24-4b89-9c08-000000000000",
"level_name": "liveness-confirmation",
"expires_at": "2026-11-15T15:04:05Z"
}
}