Step-up passkey challenge (v2)
curl --request POST \
--url https://api.next.orenda.finance/v2/auth/passkey/challenge \
--header 'Authorization: Bearer <token>' \
--header 'x-program-id: <x-program-id>'import requests
url = "https://api.next.orenda.finance/v2/auth/passkey/challenge"
headers = {
"x-program-id": "<x-program-id>",
"Authorization": "Bearer <token>"
}
response = requests.post(url, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'x-program-id': '<x-program-id>', Authorization: 'Bearer <token>'}
};
fetch('https://api.next.orenda.finance/v2/auth/passkey/challenge', 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.next.orenda.finance/v2/auth/passkey/challenge",
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>",
"x-program-id: <x-program-id>"
],
]);
$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.next.orenda.finance/v2/auth/passkey/challenge"
req, _ := http.NewRequest("POST", url, nil)
req.Header.Add("x-program-id", "<x-program-id>")
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.next.orenda.finance/v2/auth/passkey/challenge")
.header("x-program-id", "<x-program-id>")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.next.orenda.finance/v2/auth/passkey/challenge")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["x-program-id"] = '<x-program-id>'
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"success": true,
"data": {
"passkeySession": "8b2c4d6e-1f3a-4b5c-9d7e-0a1b2c3d4e5f",
"fido2options": {
"challenge": "c3RlcHVwLWNoYWxsZW5nZS1yYW5kb20",
"timeout": 120000,
"userVerification": "required",
"allowCredentials": [
{
"type": "public-key",
"id": "AbC1dEf2GhI3jKl4MnO5pQr6StU7vWx8",
"transports": [
"internal",
"hybrid"
]
}
]
}
}
}{
"success": false,
"code": "UNAUTHORIZED",
"message": "Invalid email or password"
}{
"message": "Forbidden"
}{
"success": false,
"code": "VALIDATION_ERROR",
"message": "Missing program or user context"
}{
"success": false,
"code": "USER_LOCKED",
"message": "Too many failed attempts"
}{
"success": false,
"code": "INTERNAL_SERVER_ERROR",
"message": "Internal Server Error"
}Beneficiaries
Confirm with a passkey
Get a step-up passkey challenge before adding a beneficiary.
POST
/
v2
/
auth
/
passkey
/
challenge
Step-up passkey challenge (v2)
curl --request POST \
--url https://api.next.orenda.finance/v2/auth/passkey/challenge \
--header 'Authorization: Bearer <token>' \
--header 'x-program-id: <x-program-id>'import requests
url = "https://api.next.orenda.finance/v2/auth/passkey/challenge"
headers = {
"x-program-id": "<x-program-id>",
"Authorization": "Bearer <token>"
}
response = requests.post(url, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'x-program-id': '<x-program-id>', Authorization: 'Bearer <token>'}
};
fetch('https://api.next.orenda.finance/v2/auth/passkey/challenge', 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.next.orenda.finance/v2/auth/passkey/challenge",
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>",
"x-program-id: <x-program-id>"
],
]);
$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.next.orenda.finance/v2/auth/passkey/challenge"
req, _ := http.NewRequest("POST", url, nil)
req.Header.Add("x-program-id", "<x-program-id>")
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.next.orenda.finance/v2/auth/passkey/challenge")
.header("x-program-id", "<x-program-id>")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.next.orenda.finance/v2/auth/passkey/challenge")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["x-program-id"] = '<x-program-id>'
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"success": true,
"data": {
"passkeySession": "8b2c4d6e-1f3a-4b5c-9d7e-0a1b2c3d4e5f",
"fido2options": {
"challenge": "c3RlcHVwLWNoYWxsZW5nZS1yYW5kb20",
"timeout": 120000,
"userVerification": "required",
"allowCredentials": [
{
"type": "public-key",
"id": "AbC1dEf2GhI3jKl4MnO5pQr6StU7vWx8",
"transports": [
"internal",
"hybrid"
]
}
]
}
}
}{
"success": false,
"code": "UNAUTHORIZED",
"message": "Invalid email or password"
}{
"message": "Forbidden"
}{
"success": false,
"code": "VALIDATION_ERROR",
"message": "Missing program or user context"
}{
"success": false,
"code": "USER_LOCKED",
"message": "Too many failed attempts"
}{
"success": false,
"code": "INTERNAL_SERVER_ERROR",
"message": "Internal Server Error"
}Adding a beneficiary needs a step-up confirmation. To confirm with a passkey, use the
general step-up endpoint,
It returns a
POST /v2/auth/passkey/challenge. It’s the same endpoint for every
sensitive action (adding a beneficiary, an ad-hoc international or batch payment, and so on).
- v2 (recommended)
- v1
Use
POST /v2/auth/passkey/challenge.POST /v1/auth/passkey/challenge still works and is unchanged. No field on this route is named differently.passkeySession and fido2options. Convert the base64url fields in
fido2options to bytes, pass them to navigator.credentials.get() (or the native
equivalent), and let the user unlock the passkey. That device step is the same as a
passkey login,
but don’t send the result to a login endpoint. It goes in the confirmation object when
you add the beneficiary:
"confirmation": {
"method": "passkey",
"passkeySession": "3f1c2e8a-…",
"assertion": "{\"credentialIdB64\":\"…\",\"userHandleB64\":\"…\",\"clientDataJSON_B64\":\"…\",\"authenticatorDataB64\":\"…\",\"signatureB64\":\"…\"}"
}
assertion is a JSON string with the device’s result in base64url: credentialIdB64,
userHandleB64, clientDataJSON_B64, authenticatorDataB64 and signatureB64.
The
passkeySession is valid for 3 minutes and for one request: the first request whose confirmation is checked uses it up, whether the check passes or fails.
Request a new challenge for every attempt.
An expired or spent session is a 422 SCA_EXPIRED; see
Step-up confirmation.