TransactionCallback
curl --request POST \
--url https://{domain}/api/TransactionCallback \
--header 'Content-Type: application/json' \
--data '
{
"NayaxTransactionId": 2004545072,
"SparkTransactionId": "12c7cec2-c690-4425-9a1f-db0db60e2d8c",
"SiteId": 2,
"TerminalId": "0434334921100366",
"MachineId": 71234996,
"HwSerial": "0434334921100366",
"AuthStatus": {
"Verdict": "Approved",
"ErrorCode": 0,
"ErrorDescription": "",
"StatusMessage": ""
},
"CardLast4Digits": "1234",
"CardHash": "7f2082ba5dbccf706b6987e75b62083f65b5695bc2d8c827c3e46769d007a9e6",
"CardUid": "1288528281124927",
"MachineAuTime": "20240205194122328",
"Amount": 15
}
'import requests
url = "https://{domain}/api/TransactionCallback"
payload = {
"NayaxTransactionId": 2004545072,
"SparkTransactionId": "12c7cec2-c690-4425-9a1f-db0db60e2d8c",
"SiteId": 2,
"TerminalId": "0434334921100366",
"MachineId": 71234996,
"HwSerial": "0434334921100366",
"AuthStatus": {
"Verdict": "Approved",
"ErrorCode": 0,
"ErrorDescription": "",
"StatusMessage": ""
},
"CardLast4Digits": "1234",
"CardHash": "7f2082ba5dbccf706b6987e75b62083f65b5695bc2d8c827c3e46769d007a9e6",
"CardUid": "1288528281124927",
"MachineAuTime": "20240205194122328",
"Amount": 15
}
headers = {"Content-Type": "application/json"}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'Content-Type': 'application/json'},
body: JSON.stringify({
NayaxTransactionId: 2004545072,
SparkTransactionId: '12c7cec2-c690-4425-9a1f-db0db60e2d8c',
SiteId: 2,
TerminalId: '0434334921100366',
MachineId: 71234996,
HwSerial: '0434334921100366',
AuthStatus: {Verdict: 'Approved', ErrorCode: 0, ErrorDescription: '', StatusMessage: ''},
CardLast4Digits: '1234',
CardHash: '7f2082ba5dbccf706b6987e75b62083f65b5695bc2d8c827c3e46769d007a9e6',
CardUid: '1288528281124927',
MachineAuTime: '20240205194122328',
Amount: 15
})
};
fetch('https://{domain}/api/TransactionCallback', 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://{domain}/api/TransactionCallback",
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([
'NayaxTransactionId' => 2004545072,
'SparkTransactionId' => '12c7cec2-c690-4425-9a1f-db0db60e2d8c',
'SiteId' => 2,
'TerminalId' => '0434334921100366',
'MachineId' => 71234996,
'HwSerial' => '0434334921100366',
'AuthStatus' => [
'Verdict' => 'Approved',
'ErrorCode' => 0,
'ErrorDescription' => '',
'StatusMessage' => ''
],
'CardLast4Digits' => '1234',
'CardHash' => '7f2082ba5dbccf706b6987e75b62083f65b5695bc2d8c827c3e46769d007a9e6',
'CardUid' => '1288528281124927',
'MachineAuTime' => '20240205194122328',
'Amount' => 15
]),
CURLOPT_HTTPHEADER => [
"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://{domain}/api/TransactionCallback"
payload := strings.NewReader("{\n \"NayaxTransactionId\": 2004545072,\n \"SparkTransactionId\": \"12c7cec2-c690-4425-9a1f-db0db60e2d8c\",\n \"SiteId\": 2,\n \"TerminalId\": \"0434334921100366\",\n \"MachineId\": 71234996,\n \"HwSerial\": \"0434334921100366\",\n \"AuthStatus\": {\n \"Verdict\": \"Approved\",\n \"ErrorCode\": 0,\n \"ErrorDescription\": \"\",\n \"StatusMessage\": \"\"\n },\n \"CardLast4Digits\": \"1234\",\n \"CardHash\": \"7f2082ba5dbccf706b6987e75b62083f65b5695bc2d8c827c3e46769d007a9e6\",\n \"CardUid\": \"1288528281124927\",\n \"MachineAuTime\": \"20240205194122328\",\n \"Amount\": 15\n}")
req, _ := http.NewRequest("POST", url, payload)
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://{domain}/api/TransactionCallback")
.header("Content-Type", "application/json")
.body("{\n \"NayaxTransactionId\": 2004545072,\n \"SparkTransactionId\": \"12c7cec2-c690-4425-9a1f-db0db60e2d8c\",\n \"SiteId\": 2,\n \"TerminalId\": \"0434334921100366\",\n \"MachineId\": 71234996,\n \"HwSerial\": \"0434334921100366\",\n \"AuthStatus\": {\n \"Verdict\": \"Approved\",\n \"ErrorCode\": 0,\n \"ErrorDescription\": \"\",\n \"StatusMessage\": \"\"\n },\n \"CardLast4Digits\": \"1234\",\n \"CardHash\": \"7f2082ba5dbccf706b6987e75b62083f65b5695bc2d8c827c3e46769d007a9e6\",\n \"CardUid\": \"1288528281124927\",\n \"MachineAuTime\": \"20240205194122328\",\n \"Amount\": 15\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://{domain}/api/TransactionCallback")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Content-Type"] = 'application/json'
request.body = "{\n \"NayaxTransactionId\": 2004545072,\n \"SparkTransactionId\": \"12c7cec2-c690-4425-9a1f-db0db60e2d8c\",\n \"SiteId\": 2,\n \"TerminalId\": \"0434334921100366\",\n \"MachineId\": 71234996,\n \"HwSerial\": \"0434334921100366\",\n \"AuthStatus\": {\n \"Verdict\": \"Approved\",\n \"ErrorCode\": 0,\n \"ErrorDescription\": \"\",\n \"StatusMessage\": \"\"\n },\n \"CardLast4Digits\": \"1234\",\n \"CardHash\": \"7f2082ba5dbccf706b6987e75b62083f65b5695bc2d8c827c3e46769d007a9e6\",\n \"CardUid\": \"1288528281124927\",\n \"MachineAuTime\": \"20240205194122328\",\n \"Amount\": 15\n}"
response = http.request(request)
puts response.read_body{
"SparkTransactionId": "12c7cec2-c690-4425-9a1f-db0db60e2d8c",
"Status": {
"Verdict": "Approved",
"ErrorDescription": "No Errors"
}
}Transactions
TransactionCallback
TransactionCallback
curl --request POST \
--url https://{domain}/api/TransactionCallback \
--header 'Content-Type: application/json' \
--data '
{
"NayaxTransactionId": 2004545072,
"SparkTransactionId": "12c7cec2-c690-4425-9a1f-db0db60e2d8c",
"SiteId": 2,
"TerminalId": "0434334921100366",
"MachineId": 71234996,
"HwSerial": "0434334921100366",
"AuthStatus": {
"Verdict": "Approved",
"ErrorCode": 0,
"ErrorDescription": "",
"StatusMessage": ""
},
"CardLast4Digits": "1234",
"CardHash": "7f2082ba5dbccf706b6987e75b62083f65b5695bc2d8c827c3e46769d007a9e6",
"CardUid": "1288528281124927",
"MachineAuTime": "20240205194122328",
"Amount": 15
}
'import requests
url = "https://{domain}/api/TransactionCallback"
payload = {
"NayaxTransactionId": 2004545072,
"SparkTransactionId": "12c7cec2-c690-4425-9a1f-db0db60e2d8c",
"SiteId": 2,
"TerminalId": "0434334921100366",
"MachineId": 71234996,
"HwSerial": "0434334921100366",
"AuthStatus": {
"Verdict": "Approved",
"ErrorCode": 0,
"ErrorDescription": "",
"StatusMessage": ""
},
"CardLast4Digits": "1234",
"CardHash": "7f2082ba5dbccf706b6987e75b62083f65b5695bc2d8c827c3e46769d007a9e6",
"CardUid": "1288528281124927",
"MachineAuTime": "20240205194122328",
"Amount": 15
}
headers = {"Content-Type": "application/json"}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'Content-Type': 'application/json'},
body: JSON.stringify({
NayaxTransactionId: 2004545072,
SparkTransactionId: '12c7cec2-c690-4425-9a1f-db0db60e2d8c',
SiteId: 2,
TerminalId: '0434334921100366',
MachineId: 71234996,
HwSerial: '0434334921100366',
AuthStatus: {Verdict: 'Approved', ErrorCode: 0, ErrorDescription: '', StatusMessage: ''},
CardLast4Digits: '1234',
CardHash: '7f2082ba5dbccf706b6987e75b62083f65b5695bc2d8c827c3e46769d007a9e6',
CardUid: '1288528281124927',
MachineAuTime: '20240205194122328',
Amount: 15
})
};
fetch('https://{domain}/api/TransactionCallback', 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://{domain}/api/TransactionCallback",
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([
'NayaxTransactionId' => 2004545072,
'SparkTransactionId' => '12c7cec2-c690-4425-9a1f-db0db60e2d8c',
'SiteId' => 2,
'TerminalId' => '0434334921100366',
'MachineId' => 71234996,
'HwSerial' => '0434334921100366',
'AuthStatus' => [
'Verdict' => 'Approved',
'ErrorCode' => 0,
'ErrorDescription' => '',
'StatusMessage' => ''
],
'CardLast4Digits' => '1234',
'CardHash' => '7f2082ba5dbccf706b6987e75b62083f65b5695bc2d8c827c3e46769d007a9e6',
'CardUid' => '1288528281124927',
'MachineAuTime' => '20240205194122328',
'Amount' => 15
]),
CURLOPT_HTTPHEADER => [
"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://{domain}/api/TransactionCallback"
payload := strings.NewReader("{\n \"NayaxTransactionId\": 2004545072,\n \"SparkTransactionId\": \"12c7cec2-c690-4425-9a1f-db0db60e2d8c\",\n \"SiteId\": 2,\n \"TerminalId\": \"0434334921100366\",\n \"MachineId\": 71234996,\n \"HwSerial\": \"0434334921100366\",\n \"AuthStatus\": {\n \"Verdict\": \"Approved\",\n \"ErrorCode\": 0,\n \"ErrorDescription\": \"\",\n \"StatusMessage\": \"\"\n },\n \"CardLast4Digits\": \"1234\",\n \"CardHash\": \"7f2082ba5dbccf706b6987e75b62083f65b5695bc2d8c827c3e46769d007a9e6\",\n \"CardUid\": \"1288528281124927\",\n \"MachineAuTime\": \"20240205194122328\",\n \"Amount\": 15\n}")
req, _ := http.NewRequest("POST", url, payload)
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://{domain}/api/TransactionCallback")
.header("Content-Type", "application/json")
.body("{\n \"NayaxTransactionId\": 2004545072,\n \"SparkTransactionId\": \"12c7cec2-c690-4425-9a1f-db0db60e2d8c\",\n \"SiteId\": 2,\n \"TerminalId\": \"0434334921100366\",\n \"MachineId\": 71234996,\n \"HwSerial\": \"0434334921100366\",\n \"AuthStatus\": {\n \"Verdict\": \"Approved\",\n \"ErrorCode\": 0,\n \"ErrorDescription\": \"\",\n \"StatusMessage\": \"\"\n },\n \"CardLast4Digits\": \"1234\",\n \"CardHash\": \"7f2082ba5dbccf706b6987e75b62083f65b5695bc2d8c827c3e46769d007a9e6\",\n \"CardUid\": \"1288528281124927\",\n \"MachineAuTime\": \"20240205194122328\",\n \"Amount\": 15\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://{domain}/api/TransactionCallback")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Content-Type"] = 'application/json'
request.body = "{\n \"NayaxTransactionId\": 2004545072,\n \"SparkTransactionId\": \"12c7cec2-c690-4425-9a1f-db0db60e2d8c\",\n \"SiteId\": 2,\n \"TerminalId\": \"0434334921100366\",\n \"MachineId\": 71234996,\n \"HwSerial\": \"0434334921100366\",\n \"AuthStatus\": {\n \"Verdict\": \"Approved\",\n \"ErrorCode\": 0,\n \"ErrorDescription\": \"\",\n \"StatusMessage\": \"\"\n },\n \"CardLast4Digits\": \"1234\",\n \"CardHash\": \"7f2082ba5dbccf706b6987e75b62083f65b5695bc2d8c827c3e46769d007a9e6\",\n \"CardUid\": \"1288528281124927\",\n \"MachineAuTime\": \"20240205194122328\",\n \"Amount\": 15\n}"
response = http.request(request)
puts response.read_body{
"SparkTransactionId": "12c7cec2-c690-4425-9a1f-db0db60e2d8c",
"Status": {
"Verdict": "Approved",
"ErrorDescription": "No Errors"
}
}The terminal uses the
TransactionCallback endpoint to notify the
integrator about the result of a card tap. It is triggered automatically
when a user presents a card, and an authorization flow is initiated with
the payment provider.Body
application/json
The request payload including the result of the card scan operation.
The request payload sent by the Spark platform to the integrator's configured TransactionCallback endpoint. This request includes the full result of the card scan operation and is essential for proceeding with transaction confirmation or rejection handling.
The unique internal transaction ID assigned by Nayax.
The unique session ID generated in StartAuthentication.
The ID of the vending site or Spark location.
The unique ID of the terminal that read the card.
The identifier of the vending machine or device.
The hardware serial number of the terminal.
The timestamp from the machine in the format yyyyMMddHHmmssSSS.
The object containing the card authorization result.
Show child attributes
Show child attributes
Example:
{
"Verdict": "Approved",
"ErrorCode": 0,
"ErrorDescription": "",
"StatusMessage": ""
}
The last four digits of the presented card.
The one-way hash of the full card number.
The unique identifier of the card (for prepaid cards).
The transaction amount in the main currency unit (decimal place 0, e.g., 15 for $15.00).
Response
200 - application/json
object | null
Success. A simple 200 OK server acknowledgment is sufficient.
The response payload from the integrator to Nayax's TransactionCallback, confirming the receipt of the transaction result. This callback is triggered when a user presents a card and an authorization flow is initiated.
Was this page helpful?