Simulate financial
curl --request POST \
--url https://api.synctera.com/v2/cards/transaction_simulations/financial \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"amount": 123,
"card_acceptor": {
"address": "address",
"city": "city",
"country": "country",
"ecommerce_security_level_indicator": "ecommerce_security_level_indicator",
"mcc": "mcc",
"name": "name",
"partial_approval_capable": false,
"state": "state",
"zip": "zip"
},
"card_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"mid": "<string>",
"cash_back_amount": 123,
"is_pre_auth": false,
"pin": "<string>",
"transaction_options": {
"additional_data": "<string>",
"card_expiration_date_yymm": "<string>",
"database_transaction_timeout": 123,
"encryption_key_id": "<string>",
"is_async": false,
"pre_auth_time_limit": "<string>",
"send_expiration_date": false,
"send_track_data": false,
"transaction_id": "<string>",
"transaction_timeout_threshold_seconds": 123
}
}
'import requests
url = "https://api.synctera.com/v2/cards/transaction_simulations/financial"
payload = {
"amount": 123,
"card_acceptor": {
"address": "address",
"city": "city",
"country": "country",
"ecommerce_security_level_indicator": "ecommerce_security_level_indicator",
"mcc": "mcc",
"name": "name",
"partial_approval_capable": False,
"state": "state",
"zip": "zip"
},
"card_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"mid": "<string>",
"cash_back_amount": 123,
"is_pre_auth": False,
"pin": "<string>",
"transaction_options": {
"additional_data": "<string>",
"card_expiration_date_yymm": "<string>",
"database_transaction_timeout": 123,
"encryption_key_id": "<string>",
"is_async": False,
"pre_auth_time_limit": "<string>",
"send_expiration_date": False,
"send_track_data": False,
"transaction_id": "<string>",
"transaction_timeout_threshold_seconds": 123
}
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
amount: 123,
card_acceptor: {
address: 'address',
city: 'city',
country: 'country',
ecommerce_security_level_indicator: 'ecommerce_security_level_indicator',
mcc: 'mcc',
name: 'name',
partial_approval_capable: false,
state: 'state',
zip: 'zip'
},
card_id: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
mid: '<string>',
cash_back_amount: 123,
is_pre_auth: false,
pin: '<string>',
transaction_options: {
additional_data: '<string>',
card_expiration_date_yymm: '<string>',
database_transaction_timeout: 123,
encryption_key_id: '<string>',
is_async: false,
pre_auth_time_limit: '<string>',
send_expiration_date: false,
send_track_data: false,
transaction_id: '<string>',
transaction_timeout_threshold_seconds: 123
}
})
};
fetch('https://api.synctera.com/v2/cards/transaction_simulations/financial', 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.synctera.com/v2/cards/transaction_simulations/financial",
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([
'amount' => 123,
'card_acceptor' => [
'address' => 'address',
'city' => 'city',
'country' => 'country',
'ecommerce_security_level_indicator' => 'ecommerce_security_level_indicator',
'mcc' => 'mcc',
'name' => 'name',
'partial_approval_capable' => false,
'state' => 'state',
'zip' => 'zip'
],
'card_id' => '3c90c3cc-0d44-4b50-8888-8dd25736052a',
'mid' => '<string>',
'cash_back_amount' => 123,
'is_pre_auth' => false,
'pin' => '<string>',
'transaction_options' => [
'additional_data' => '<string>',
'card_expiration_date_yymm' => '<string>',
'database_transaction_timeout' => 123,
'encryption_key_id' => '<string>',
'is_async' => false,
'pre_auth_time_limit' => '<string>',
'send_expiration_date' => false,
'send_track_data' => false,
'transaction_id' => '<string>',
'transaction_timeout_threshold_seconds' => 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.synctera.com/v2/cards/transaction_simulations/financial"
payload := strings.NewReader("{\n \"amount\": 123,\n \"card_acceptor\": {\n \"address\": \"address\",\n \"city\": \"city\",\n \"country\": \"country\",\n \"ecommerce_security_level_indicator\": \"ecommerce_security_level_indicator\",\n \"mcc\": \"mcc\",\n \"name\": \"name\",\n \"partial_approval_capable\": false,\n \"state\": \"state\",\n \"zip\": \"zip\"\n },\n \"card_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"mid\": \"<string>\",\n \"cash_back_amount\": 123,\n \"is_pre_auth\": false,\n \"pin\": \"<string>\",\n \"transaction_options\": {\n \"additional_data\": \"<string>\",\n \"card_expiration_date_yymm\": \"<string>\",\n \"database_transaction_timeout\": 123,\n \"encryption_key_id\": \"<string>\",\n \"is_async\": false,\n \"pre_auth_time_limit\": \"<string>\",\n \"send_expiration_date\": false,\n \"send_track_data\": false,\n \"transaction_id\": \"<string>\",\n \"transaction_timeout_threshold_seconds\": 123\n }\n}")
req, _ := http.NewRequest("POST", 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.post("https://api.synctera.com/v2/cards/transaction_simulations/financial")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"amount\": 123,\n \"card_acceptor\": {\n \"address\": \"address\",\n \"city\": \"city\",\n \"country\": \"country\",\n \"ecommerce_security_level_indicator\": \"ecommerce_security_level_indicator\",\n \"mcc\": \"mcc\",\n \"name\": \"name\",\n \"partial_approval_capable\": false,\n \"state\": \"state\",\n \"zip\": \"zip\"\n },\n \"card_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"mid\": \"<string>\",\n \"cash_back_amount\": 123,\n \"is_pre_auth\": false,\n \"pin\": \"<string>\",\n \"transaction_options\": {\n \"additional_data\": \"<string>\",\n \"card_expiration_date_yymm\": \"<string>\",\n \"database_transaction_timeout\": 123,\n \"encryption_key_id\": \"<string>\",\n \"is_async\": false,\n \"pre_auth_time_limit\": \"<string>\",\n \"send_expiration_date\": false,\n \"send_track_data\": false,\n \"transaction_id\": \"<string>\",\n \"transaction_timeout_threshold_seconds\": 123\n }\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.synctera.com/v2/cards/transaction_simulations/financial")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"amount\": 123,\n \"card_acceptor\": {\n \"address\": \"address\",\n \"city\": \"city\",\n \"country\": \"country\",\n \"ecommerce_security_level_indicator\": \"ecommerce_security_level_indicator\",\n \"mcc\": \"mcc\",\n \"name\": \"name\",\n \"partial_approval_capable\": false,\n \"state\": \"state\",\n \"zip\": \"zip\"\n },\n \"card_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"mid\": \"<string>\",\n \"cash_back_amount\": 123,\n \"is_pre_auth\": false,\n \"pin\": \"<string>\",\n \"transaction_options\": {\n \"additional_data\": \"<string>\",\n \"card_expiration_date_yymm\": \"<string>\",\n \"database_transaction_timeout\": 123,\n \"encryption_key_id\": \"<string>\",\n \"is_async\": false,\n \"pre_auth_time_limit\": \"<string>\",\n \"send_expiration_date\": false,\n \"send_track_data\": false,\n \"transaction_id\": \"<string>\",\n \"transaction_timeout_threshold_seconds\": 123\n }\n}"
response = http.request(request)
puts response.read_body{}{
"code": "BAD_REQUEST_BODY",
"detail": "Missing required fields: first_name, dob",
"status": 400
}{
"code": "BAD_REQUEST_BODY",
"detail": "Missing required fields: first_name, dob",
"status": 400
}{
"code": "BAD_REQUEST_BODY",
"detail": "Missing required fields: first_name, dob",
"status": 400
}{
"code": "BAD_REQUEST_BODY",
"detail": "Missing required fields: first_name, dob",
"status": 400
}Card Transaction Simulations
Simulate financial
A “financial” is a transaction message class that includes ATM transactions, PIN-debit transactions, and balance inquiries.
Simulate a pindebit type transaction by including the card_token and amount in your request.
POST
/
cards
/
transaction_simulations
/
financial
Simulate financial
curl --request POST \
--url https://api.synctera.com/v2/cards/transaction_simulations/financial \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"amount": 123,
"card_acceptor": {
"address": "address",
"city": "city",
"country": "country",
"ecommerce_security_level_indicator": "ecommerce_security_level_indicator",
"mcc": "mcc",
"name": "name",
"partial_approval_capable": false,
"state": "state",
"zip": "zip"
},
"card_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"mid": "<string>",
"cash_back_amount": 123,
"is_pre_auth": false,
"pin": "<string>",
"transaction_options": {
"additional_data": "<string>",
"card_expiration_date_yymm": "<string>",
"database_transaction_timeout": 123,
"encryption_key_id": "<string>",
"is_async": false,
"pre_auth_time_limit": "<string>",
"send_expiration_date": false,
"send_track_data": false,
"transaction_id": "<string>",
"transaction_timeout_threshold_seconds": 123
}
}
'import requests
url = "https://api.synctera.com/v2/cards/transaction_simulations/financial"
payload = {
"amount": 123,
"card_acceptor": {
"address": "address",
"city": "city",
"country": "country",
"ecommerce_security_level_indicator": "ecommerce_security_level_indicator",
"mcc": "mcc",
"name": "name",
"partial_approval_capable": False,
"state": "state",
"zip": "zip"
},
"card_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"mid": "<string>",
"cash_back_amount": 123,
"is_pre_auth": False,
"pin": "<string>",
"transaction_options": {
"additional_data": "<string>",
"card_expiration_date_yymm": "<string>",
"database_transaction_timeout": 123,
"encryption_key_id": "<string>",
"is_async": False,
"pre_auth_time_limit": "<string>",
"send_expiration_date": False,
"send_track_data": False,
"transaction_id": "<string>",
"transaction_timeout_threshold_seconds": 123
}
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
amount: 123,
card_acceptor: {
address: 'address',
city: 'city',
country: 'country',
ecommerce_security_level_indicator: 'ecommerce_security_level_indicator',
mcc: 'mcc',
name: 'name',
partial_approval_capable: false,
state: 'state',
zip: 'zip'
},
card_id: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
mid: '<string>',
cash_back_amount: 123,
is_pre_auth: false,
pin: '<string>',
transaction_options: {
additional_data: '<string>',
card_expiration_date_yymm: '<string>',
database_transaction_timeout: 123,
encryption_key_id: '<string>',
is_async: false,
pre_auth_time_limit: '<string>',
send_expiration_date: false,
send_track_data: false,
transaction_id: '<string>',
transaction_timeout_threshold_seconds: 123
}
})
};
fetch('https://api.synctera.com/v2/cards/transaction_simulations/financial', 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.synctera.com/v2/cards/transaction_simulations/financial",
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([
'amount' => 123,
'card_acceptor' => [
'address' => 'address',
'city' => 'city',
'country' => 'country',
'ecommerce_security_level_indicator' => 'ecommerce_security_level_indicator',
'mcc' => 'mcc',
'name' => 'name',
'partial_approval_capable' => false,
'state' => 'state',
'zip' => 'zip'
],
'card_id' => '3c90c3cc-0d44-4b50-8888-8dd25736052a',
'mid' => '<string>',
'cash_back_amount' => 123,
'is_pre_auth' => false,
'pin' => '<string>',
'transaction_options' => [
'additional_data' => '<string>',
'card_expiration_date_yymm' => '<string>',
'database_transaction_timeout' => 123,
'encryption_key_id' => '<string>',
'is_async' => false,
'pre_auth_time_limit' => '<string>',
'send_expiration_date' => false,
'send_track_data' => false,
'transaction_id' => '<string>',
'transaction_timeout_threshold_seconds' => 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.synctera.com/v2/cards/transaction_simulations/financial"
payload := strings.NewReader("{\n \"amount\": 123,\n \"card_acceptor\": {\n \"address\": \"address\",\n \"city\": \"city\",\n \"country\": \"country\",\n \"ecommerce_security_level_indicator\": \"ecommerce_security_level_indicator\",\n \"mcc\": \"mcc\",\n \"name\": \"name\",\n \"partial_approval_capable\": false,\n \"state\": \"state\",\n \"zip\": \"zip\"\n },\n \"card_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"mid\": \"<string>\",\n \"cash_back_amount\": 123,\n \"is_pre_auth\": false,\n \"pin\": \"<string>\",\n \"transaction_options\": {\n \"additional_data\": \"<string>\",\n \"card_expiration_date_yymm\": \"<string>\",\n \"database_transaction_timeout\": 123,\n \"encryption_key_id\": \"<string>\",\n \"is_async\": false,\n \"pre_auth_time_limit\": \"<string>\",\n \"send_expiration_date\": false,\n \"send_track_data\": false,\n \"transaction_id\": \"<string>\",\n \"transaction_timeout_threshold_seconds\": 123\n }\n}")
req, _ := http.NewRequest("POST", 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.post("https://api.synctera.com/v2/cards/transaction_simulations/financial")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"amount\": 123,\n \"card_acceptor\": {\n \"address\": \"address\",\n \"city\": \"city\",\n \"country\": \"country\",\n \"ecommerce_security_level_indicator\": \"ecommerce_security_level_indicator\",\n \"mcc\": \"mcc\",\n \"name\": \"name\",\n \"partial_approval_capable\": false,\n \"state\": \"state\",\n \"zip\": \"zip\"\n },\n \"card_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"mid\": \"<string>\",\n \"cash_back_amount\": 123,\n \"is_pre_auth\": false,\n \"pin\": \"<string>\",\n \"transaction_options\": {\n \"additional_data\": \"<string>\",\n \"card_expiration_date_yymm\": \"<string>\",\n \"database_transaction_timeout\": 123,\n \"encryption_key_id\": \"<string>\",\n \"is_async\": false,\n \"pre_auth_time_limit\": \"<string>\",\n \"send_expiration_date\": false,\n \"send_track_data\": false,\n \"transaction_id\": \"<string>\",\n \"transaction_timeout_threshold_seconds\": 123\n }\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.synctera.com/v2/cards/transaction_simulations/financial")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"amount\": 123,\n \"card_acceptor\": {\n \"address\": \"address\",\n \"city\": \"city\",\n \"country\": \"country\",\n \"ecommerce_security_level_indicator\": \"ecommerce_security_level_indicator\",\n \"mcc\": \"mcc\",\n \"name\": \"name\",\n \"partial_approval_capable\": false,\n \"state\": \"state\",\n \"zip\": \"zip\"\n },\n \"card_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"mid\": \"<string>\",\n \"cash_back_amount\": 123,\n \"is_pre_auth\": false,\n \"pin\": \"<string>\",\n \"transaction_options\": {\n \"additional_data\": \"<string>\",\n \"card_expiration_date_yymm\": \"<string>\",\n \"database_transaction_timeout\": 123,\n \"encryption_key_id\": \"<string>\",\n \"is_async\": false,\n \"pre_auth_time_limit\": \"<string>\",\n \"send_expiration_date\": false,\n \"send_track_data\": false,\n \"transaction_id\": \"<string>\",\n \"transaction_timeout_threshold_seconds\": 123\n }\n}"
response = http.request(request)
puts response.read_body{}{
"code": "BAD_REQUEST_BODY",
"detail": "Missing required fields: first_name, dob",
"status": 400
}{
"code": "BAD_REQUEST_BODY",
"detail": "Missing required fields: first_name, dob",
"status": 400
}{
"code": "BAD_REQUEST_BODY",
"detail": "Missing required fields: first_name, dob",
"status": 400
}{
"code": "BAD_REQUEST_BODY",
"detail": "Missing required fields: first_name, dob",
"status": 400
}Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Body
application/json
Financial details
The amount of the transaction in the smallest whole denomination of the applicable currency (eg. For USD use cents)
Show child attributes
Show child attributes
Example:
{
"address": "address",
"city": "city",
"country": "country",
"ecommerce_security_level_indicator": "ecommerce_security_level_indicator",
"mcc": "mcc",
"name": "name",
"partial_approval_capable": false,
"state": "state",
"zip": "zip"
}
Required string length:
1 - 50Cash back amount in the smallest whole denomination of the applicable currency (eg. For USD use cents)
Required string length:
1 - 15Show child attributes
Show child attributes
Response
Success
The response is of type object.
Was this page helpful?
⌘I