curl --request PUT \
--url https://api.sandbox.tesouro.com/embedded-banking/v1/authorization-controls/velocity-controls/{id} \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"active": true,
"amountLimit": 123,
"cardId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"currencyCode": "<string>",
"mcc": "<string>",
"mccGroup": "<string>",
"name": "<string>",
"usageLimit": 123
}
'import requests
url = "https://api.sandbox.tesouro.com/embedded-banking/v1/authorization-controls/velocity-controls/{id}"
payload = {
"active": True,
"amountLimit": 123,
"cardId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"currencyCode": "<string>",
"mcc": "<string>",
"mccGroup": "<string>",
"name": "<string>",
"usageLimit": 123
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.put(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'PUT',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
active: true,
amountLimit: 123,
cardId: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
currencyCode: '<string>',
mcc: '<string>',
mccGroup: '<string>',
name: '<string>',
usageLimit: 123
})
};
fetch('https://api.sandbox.tesouro.com/embedded-banking/v1/authorization-controls/velocity-controls/{id}', 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.tesouro.com/embedded-banking/v1/authorization-controls/velocity-controls/{id}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "PUT",
CURLOPT_POSTFIELDS => json_encode([
'active' => true,
'amountLimit' => 123,
'cardId' => '3c90c3cc-0d44-4b50-8888-8dd25736052a',
'currencyCode' => '<string>',
'mcc' => '<string>',
'mccGroup' => '<string>',
'name' => '<string>',
'usageLimit' => 123
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$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.sandbox.tesouro.com/embedded-banking/v1/authorization-controls/velocity-controls/{id}"
payload := strings.NewReader("{\n \"active\": true,\n \"amountLimit\": 123,\n \"cardId\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"currencyCode\": \"<string>\",\n \"mcc\": \"<string>\",\n \"mccGroup\": \"<string>\",\n \"name\": \"<string>\",\n \"usageLimit\": 123\n}")
req, _ := http.NewRequest("PUT", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
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.put("https://api.sandbox.tesouro.com/embedded-banking/v1/authorization-controls/velocity-controls/{id}")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"active\": true,\n \"amountLimit\": 123,\n \"cardId\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"currencyCode\": \"<string>\",\n \"mcc\": \"<string>\",\n \"mccGroup\": \"<string>\",\n \"name\": \"<string>\",\n \"usageLimit\": 123\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.sandbox.tesouro.com/embedded-banking/v1/authorization-controls/velocity-controls/{id}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Put.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"active\": true,\n \"amountLimit\": 123,\n \"cardId\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"currencyCode\": \"<string>\",\n \"mcc\": \"<string>\",\n \"mccGroup\": \"<string>\",\n \"name\": \"<string>\",\n \"usageLimit\": 123\n}"
response = http.request(request)
puts response.read_body{
"id": "<string>",
"active": true,
"amountLimit": 123,
"createdAt": "2023-11-07T05:31:56Z",
"currencyCode": "<string>",
"name": "<string>",
"updatedAt": "2023-11-07T05:31:56Z",
"velocityWindow": "DAY",
"cardId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"mcc": "<string>",
"mccGroup": "<string>",
"organizationId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"usageLimit": 123
}{
"detail": "<string>",
"errorCode": "<string>",
"instance": "<string>",
"status": 123,
"title": "<string>",
"type": "<string>"
}{
"detail": "<string>",
"instance": "<string>",
"status": 123,
"title": "<string>",
"type": "<string>"
}{
"detail": "<string>",
"errorCode": "<string>",
"instance": "<string>",
"status": 123,
"title": "<string>",
"type": "<string>"
}{
"detail": "<string>",
"errorCode": "<string>",
"instance": "<string>",
"status": 123,
"title": "<string>",
"type": "<string>"
}{
"detail": "<string>",
"errorCode": "<string>",
"instance": "<string>",
"status": 123,
"title": "<string>",
"type": "<string>"
}{
"detail": "<string>",
"errorCode": "<string>",
"instance": "<string>",
"status": 123,
"title": "<string>",
"type": "<string>"
}Update velocity control
Updates a velocity control. Only supplied fields are applied.
Token types: APP, USER | Required scopes: authorization_control:write:org
curl --request PUT \
--url https://api.sandbox.tesouro.com/embedded-banking/v1/authorization-controls/velocity-controls/{id} \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"active": true,
"amountLimit": 123,
"cardId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"currencyCode": "<string>",
"mcc": "<string>",
"mccGroup": "<string>",
"name": "<string>",
"usageLimit": 123
}
'import requests
url = "https://api.sandbox.tesouro.com/embedded-banking/v1/authorization-controls/velocity-controls/{id}"
payload = {
"active": True,
"amountLimit": 123,
"cardId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"currencyCode": "<string>",
"mcc": "<string>",
"mccGroup": "<string>",
"name": "<string>",
"usageLimit": 123
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.put(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'PUT',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
active: true,
amountLimit: 123,
cardId: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
currencyCode: '<string>',
mcc: '<string>',
mccGroup: '<string>',
name: '<string>',
usageLimit: 123
})
};
fetch('https://api.sandbox.tesouro.com/embedded-banking/v1/authorization-controls/velocity-controls/{id}', 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.tesouro.com/embedded-banking/v1/authorization-controls/velocity-controls/{id}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "PUT",
CURLOPT_POSTFIELDS => json_encode([
'active' => true,
'amountLimit' => 123,
'cardId' => '3c90c3cc-0d44-4b50-8888-8dd25736052a',
'currencyCode' => '<string>',
'mcc' => '<string>',
'mccGroup' => '<string>',
'name' => '<string>',
'usageLimit' => 123
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$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.sandbox.tesouro.com/embedded-banking/v1/authorization-controls/velocity-controls/{id}"
payload := strings.NewReader("{\n \"active\": true,\n \"amountLimit\": 123,\n \"cardId\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"currencyCode\": \"<string>\",\n \"mcc\": \"<string>\",\n \"mccGroup\": \"<string>\",\n \"name\": \"<string>\",\n \"usageLimit\": 123\n}")
req, _ := http.NewRequest("PUT", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
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.put("https://api.sandbox.tesouro.com/embedded-banking/v1/authorization-controls/velocity-controls/{id}")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"active\": true,\n \"amountLimit\": 123,\n \"cardId\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"currencyCode\": \"<string>\",\n \"mcc\": \"<string>\",\n \"mccGroup\": \"<string>\",\n \"name\": \"<string>\",\n \"usageLimit\": 123\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.sandbox.tesouro.com/embedded-banking/v1/authorization-controls/velocity-controls/{id}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Put.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"active\": true,\n \"amountLimit\": 123,\n \"cardId\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"currencyCode\": \"<string>\",\n \"mcc\": \"<string>\",\n \"mccGroup\": \"<string>\",\n \"name\": \"<string>\",\n \"usageLimit\": 123\n}"
response = http.request(request)
puts response.read_body{
"id": "<string>",
"active": true,
"amountLimit": 123,
"createdAt": "2023-11-07T05:31:56Z",
"currencyCode": "<string>",
"name": "<string>",
"updatedAt": "2023-11-07T05:31:56Z",
"velocityWindow": "DAY",
"cardId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"mcc": "<string>",
"mccGroup": "<string>",
"organizationId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"usageLimit": 123
}{
"detail": "<string>",
"errorCode": "<string>",
"instance": "<string>",
"status": 123,
"title": "<string>",
"type": "<string>"
}{
"detail": "<string>",
"instance": "<string>",
"status": 123,
"title": "<string>",
"type": "<string>"
}{
"detail": "<string>",
"errorCode": "<string>",
"instance": "<string>",
"status": 123,
"title": "<string>",
"type": "<string>"
}{
"detail": "<string>",
"errorCode": "<string>",
"instance": "<string>",
"status": 123,
"title": "<string>",
"type": "<string>"
}{
"detail": "<string>",
"errorCode": "<string>",
"instance": "<string>",
"status": 123,
"title": "<string>",
"type": "<string>"
}{
"detail": "<string>",
"errorCode": "<string>",
"instance": "<string>",
"status": 123,
"title": "<string>",
"type": "<string>"
}Authorizations
Application (M2M) OAuth2 access token (client credentials).
Headers
ID of the organization to perform this operation on behalf of. Required for BANK and PLATFORM app token callers targeting a specific organization. If omitted, the request uses the authenticated caller's own organization. Must be a valid non-empty UUID. Present but malformed values return 400.
Path Parameters
Body
A partial update to a velocity control. Only supplied fields are applied. When long? UpdateVelocityControlRequest.AmountLimit is supplied, string? UpdateVelocityControlRequest.CurrencyCode must be supplied too.
Maximum spend within the window, in the currency's minor units (e.g. cents).
ISO 4217 currency code (e.g. USD). Required when long? UpdateVelocityControlRequest.AmountLimit is set.
The rolling period a velocity control's amount and usage limits are evaluated over.
TRANSACTION applies the limit per-transaction and therefore carries no usage limit.
DAY, LIFETIME, MONTH, TRANSACTION, WEEK Response
OK
A velocity control. Exactly one of Guid? VelocityControlResponse.OrganizationId (organization-scoped) or Guid? VelocityControlResponse.CardId (card-scoped) is set.
Maximum spend within the window, in the currency's minor units (e.g. cents).
ISO 4217 currency code (e.g. USD).
The rolling period a velocity control's amount and usage limits are evaluated over.
TRANSACTION applies the limit per-transaction and therefore carries no usage limit.
DAY, LIFETIME, MONTH, TRANSACTION, WEEK Was this page helpful?